Skip to content

dkdc-io/zorto

Repository files navigation

Zorto

GitHub Release PyPI crates.io CI License: MIT

The AI-native static site generator (SSG) with executable code blocks, inspired by Zola and Quarto.

Install

curl -LsSf https://dkdc.sh/zorto/install.sh | sh

Verify:

zorto --version
More install options

The curl | sh installer above wraps uv tool install zorto. On Linux and macOS it pulls a pre-built wheel from PyPI that bundles the Rust engine (no compile step). Windows is not covered by the installer — use cargo from source or run under WSL.

uv (PyPI wheel, no compile):

uv tool install zorto

uvx (run once without installing):

uvx zorto

cargo (build from source, requires Rust 1.85+):

cargo install zorto

Usage

zorto --help

Slide decks

Zorto ships a reveal.js-powered presentation mode: one markdown file per slide, with frontmatter for layout, background, and transitions. Arrow keys, speaker view, fullscreen, and overview mode are built in, so a deck is just a directory of .md files that a human or agent can draft, reorder, or hand off without touching HTML.

Executable code blocks

Use {bash} or {python} in code blocks to execute them.

echo "hello"
echo "Built on $(uname -s) $(uname -m) at $(date -u '+%Y-%m-%d %H:%M UTC')"
for i in range(5):
    print(i)

Tip

If you're reading elsewhere, see https://zorto.dev for the rendered results of the code blocks above.

About

The AI-native static site generator (SSG) with executable code blocks, inspired by Zola and Quarto.

Topics

Resources

License

Stars

Watchers

Forks

Contributors