入门

30 秒上手 folio。

1. 装

npx @foliolang/cli init

这会生成 article.md、folio.config.json、.env.example。init 会问你用哪个 LLM provider，按提示选。

2. 配 API key

cp .env.example .env
# 编辑 .env，填入你的 DEEPSEEK_API_KEY（或别的 provider）

或者直接 export：

export DEEPSEEK_API_KEY=sk-...

3. 写 + 编译

打开 article.md，按 语法 写内容。然后：

npx @foliolang/cli build article.md

输出 article.html，浏览器直接打开。

4. 实时预览（可选）

npx @foliolang/cli dev article.md

打开 http://localhost:5173，保存 article.md 浏览器自动刷新。

编译流程

接下来

• 完整语法 →
• 跟 agent 联调 →
• 所有 CLI 命令 →