Skip to main content
Beyond JSONL and CSV, KiwiFS can render markdown into deliverable formats using Pandoc, Marp, and MkDocs tooling (bundled in the Docker image).

Endpoint

POST /api/kiwi/export/document
Content-Type: application/json

Request body

format
string
required
Output format: pdf, html, slides, or site.
path
string
required
File or directory under the knowledge root to render.
theme
string
Theme name for HTML/PDF output.
self_contained
boolean
default:"false"
Produce a single-file HTML with embedded assets.
bibliography
string
BibTeX path for citations.
csl_style
string
Citation style preset: apa, ieee, chicago, vancouver, or harvard.
pdf_engine
string
PDF engine: typst or xelatex (default: auto-detect).
slide_format
string
Slide format (Marp).
site_name
string
Static site title (for site format).
site_url
string
Canonical site URL.
repo_url
string
Edit-on-GitHub style link for the generated site.

Examples

kiwifs export --format pdf --path docs/report.md --output report.pdf --theme paper
kiwifs export --format html --path concepts/ --self-contained --output site.html
kiwifs export --format slides --path talks/intro.md --output slides.html
kiwifs export --format site --path docs/ --site-name "My Wiki" --output docs-site.zip
The response streams the rendered artifact with an appropriate Content-Type. Large exports may take up to five minutes server-side.

MCP

kiwi_export_document accepts the same options for agent-driven publishing workflows.

Docker requirement

PDF and site generation depend on external tools bundled in the official Docker image. Bare-metal installs may need Pandoc and related dependencies installed separately.

Export overview

JSONL, CSV, and Parquet export.

Import/export API

REST reference.
Last modified on May 23, 2026