Skip to main content
KiwiFS extends standard markdown with fenced code blocks that render as interactive widgets in the web UI. These blocks are portable — they degrade gracefully to plain code blocks in any markdown viewer.

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.
Supported chart types: bar, line, area, pie, radar, scatter.
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.
The result updates whenever the page is viewed. See DQL for the full query language.

kiwi-kanban

Renders an inline kanban board from YAML column and card definitions.
For workflow-driven kanban boards that read from file frontmatter, use the Kanban toolbar view instead.

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.
The iframe is sandboxed. It cannot access the parent page, make network requests, or use cookies.

kiwi-diff

Renders annotated inline diffs with syntax highlighting.

kiwi-progress

Renders progress bars or gauge indicators.
Supported types: 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.
Units like KB, million, and / day are parsed as quantities. Derivations stay in the page so agents can read the same numbers without the UI.

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.
Sequence diagrams also work — omit messages and KiwiFS reveals one hop per step.

kiwi-data

Structured records, not code. The server indexes them so DQL can query FROM 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:
If the manifest is missing, KiwiFS falls back to frontmatter order, then filename.

Page tracker

Progress widgets for curricula or checklists. Modes switch which frontmatter fields are shown.
Bookmarks persist per page. Banner chips under the title come from [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:
Add - or + to make callouts foldable:

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.
Last modified on August 20, 2026