Block types
Charts
Bar, line, area, pie, radar, and scatter charts from YAML data.
DQL queries
Inline tables and lists driven by DQL queries over frontmatter.
Kanban
Inline kanban boards from YAML column definitions.
Playground
Interactive widgets with sliders, toggles, selects, and color pickers.
App
Sandboxed HTML/CSS/JS running in an iframe.
Diff
Annotated inline diffs with add/remove highlighting.
Progress
Progress bars and gauge indicators.
Color
Color palette swatches for design systems.
Mermaid
Flowcharts, sequence diagrams, and other Mermaid diagrams.
Live widget
React Live code blocks that render in the browser.
Calc
Back-of-envelope math with tunable assumptions.
Steps
Stepped Mermaid walkthroughs with playback.
Structured data
kiwi-data records queryable with FROM RECORDS.Claims
Provenance badges for sourced vs inferred assertions.
kiwi-chart
Renders bar, line, area, pie, radar, or scatter charts from inline YAML data.bar, line, area, pie, radar, scatter.
Multi-series charts
Multi-series charts
Use named series for grouped or stacked visualizations:
kiwi-query
Renders a DQL query result as an inline table or list. The query runs against frontmatter metadata.kiwi-kanban
Renders an inline kanban board from YAML column and card definitions.kiwi-playground
Interactive widgets with controls that update in real time. Useful for documenting configurable parameters.kiwi-app
Runs sandboxed HTML, CSS, and JavaScript in an iframe.kiwi-diff
Renders annotated inline diffs with syntax highlighting.kiwi-progress
Renders progress bars or gauge indicators.bar, gauge.
kiwi-color
Renders color palette swatches.Mermaid diagrams
Standard Mermaid fenced blocks render as diagrams.Live widgets
widget:live
React Live code blocks that compile and render in the browser.widget:code
Python code blocks that run via Pyodide in the browser.kiwi-calc
Interactive back-of-envelope math. Assumptions sit above---. Derivations below it recompute live. Click Tune in the web UI to adjust sliders.
kiwi-steps
A Mermaid diagram plus a step list. Each step can focus or dim nodes and show a note. Playback controls appear under the diagram.messages and KiwiFS reveals one hop per step.
kiwi-data
Structured records, not code. The server indexes them so DQL can queryFROM RECORDS "<kind>".
A parse error falls back to the raw source plus the parser’s complaint — the same mistake the indexer logs.
Claims
Mark assertions so sourced claims look different from unsupported ones.Figures and embeds
Wrap media so it can go wide, pin while scrolling, or embed a canvas / Excalidraw file.![[path]] embeds .excalidraw.md and .canvas.json inline. Use |wide or |full for layout.
Reading order
Place_book.yaml next to a chapter to drive prev/next navigation at the bottom of each page:
order, then filename.
Page tracker
Progress widgets for curricula or checklists. Modes switch which frontmatter fields are shown.[ui.tags] banner in config.
Container directives
Tabs
Wrap content in tab groups using:::tabs and ::tab[label]:
Columns
Split content into columns with:::columns and :::col:
Callouts
KiwiFS supports GitHub-style callouts and foldable variants:- or + to make callouts foldable:
Related
DQL
Query language powering kiwi-query blocks.
Workflows
State machines behind Kanban boards.
Web UI
Full-screen views and editing features.
Canvas
Spatial diagrams in .canvas.json files.