Getting started

30 seconds to your first folio document.

1. Install

npx @foliolang/cli init

This generates article.md, folio.config.json, and .env.example. The init wizard asks which LLM provider you want to use; follow the prompts.

2. Configure your API key

cp .env.example .env
# Edit .env and fill in your DEEPSEEK_API_KEY (or another provider)

Or just export it directly:

export DEEPSEEK_API_KEY=sk-...

3. Write and build

Open article.md and write content using the syntax. Then:

npx @foliolang/cli build article.md

Out comes article.html. Open it in any browser.

4. Live preview (optional)

npx @foliolang/cli dev article.md

Open http://localhost:5173. Save article.md and the browser refreshes automatically.

Build pipeline

Next

• Full syntax →
• Wire up an agent →
• All CLI commands →