static site generator

Build docs that stay fresh

aphid is a fast, opinionated static site generator with first-class support for blogs, wikis, and documentation — all from Markdown.

Get Started →
$ cargo install aphid --locked
Blog + Wiki
First-class content types with distinct layouts and navigation
[[Wiki Links]]
Cross-link any page by filename stem — resolves across blog, wiki, and pages
Themes
Swap the entire look with a single config change
Markdown
Frontmatter, TOC generation, and syntax highlighting built in

Built for speed

aphid is written in Rust which is blazingly fast and allows fearless concurrency. As a result rendering your site is multithreaded to utilize all cores of your CPU and be really quick.

The Dev server rebuilds run on the rayon threadpool while tokio keeps serving HTTP and WebSocket traffic. File-change reloads land before you’ve switched windows.


Simple project structure

Keep content and configuration in one clean directory. aphid watches for changes and rebuilds only what’s needed. The same Markdown drives the blog, the wiki, and standalone pages — and [[wiki-links]] resolve across all three.

my-site/
├── aphid.toml
├── content/
│   ├── home.md
│   ├── blog/
│   │   └── first-post.md
│   ├── wiki/
│   │   └── installation.md
│   └── pages/
│       └── about.md
└── static/
    └── images/

Flexible theming

Themes are plain Tera templates plus static assets — swap the entire look with a single theme line in aphid.toml, or fork the default and tweak. Loops, conditionals, and inheritance give you full control over the rendered HTML.


Read the docs →

Latest from the blog

All posts →
aphid release breaking wiki themes 2026-05-19 · 3 min read

aphid 0.3.0

Rich wiki categories with descriptions and icons, a card-based wiki index, and an optional wiki intro page — the wiki gets a proper landing experience.

Read post →
aphid release breaking ai themes 2026-05-16 · 5 min read

aphid 0.2.2

AI-agent skill scaffolding via `aphid agent`, a popularity-sorted tag cloud on the home page, and a clearer tag page that splits blog posts and wiki pages into separate sections.

Read post →
aphid release content markdown 2026-05-15 · 4 min read

aphid 0.2.1

A content-polish release. Wiki-links now accept `[[page#section]]` anchors, headings take `{#custom-id}` overrides, author config gains a dedicated `link` field, every page ships OpenGraph + Twitter card meta tags, and blog posts expose a reading-time estimate.

Read post →

Browse by topic

All tags →