Syntax

folio is extended markdown — every bit of plain markdown still works, plus two structural primitives: command blocks ::: and named data blocks @.

Command blocks

A triple-colon fence whose first line begins with /command-name:

::: /插入图表 引用@销售
Bar chart, X = quarter, Y = sales
Highlight Q4
:::

Inside the fence:

• First line: /command [args...]
• 引用@xxx: a special argument referencing a data block. xxx must not contain spaces.
• A single command can take multiple 引用@ arguments.
• Subsequent lines: natural-language body.

Named data blocks

A block that starts with @name and can be referenced by 引用@:

Resolution order:

1. Look for a @xxx of the same name in the same file.
2. If not found, look for xxx.csv / xxx.json / xxx.md in the same directory.
3. If still not found, error out.

Five built-in commands

/插入表格 (insert-table)

No LLM call — pure data → HTML table.

/插入图表 (insert-chart)

LLM turns description + data → Vega-Lite spec → interactive in-browser rendering.

/插入流程图 (insert-flowchart)

LLM emits Mermaid code → rendered in the browser.

/插入插图 (insert-illustration)

Calls an image API (Zhipu CogView / Gemini Imagen / OpenAI gpt-image-1) and produces PNG/JPEG.

/插入交互 (insert-interactive)

LLM picks one of 4 built-in widgets (filterable-table / tabs / slider-calc / accordion), fills in its config → rendered in the browser.

Next

• Wire up an agent →
• Write your own command →