Kiln: an Obsidian static website generator

Bake your Obsidian vault into a blazing fast static site.

Kiln is a zero-config static site generator built specifically for Obsidian. It takes your local Markdown vault—including your images, canvases, graphs, and math—and "bakes" it into a highly optimized, interactive HTML website.

Unlike other generators that require complex configuration or rigid folder structures, Kiln follows a "Parity First" philosophy: if it renders in Obsidian, it should render in Kiln.

Get Started

Kiln is distributed as a single binary with no dependencies. You can be up and running in seconds.

Installation

The recommended way to install Kiln is via Go:

go install github.com/otaleghani/kiln/cmd/kiln@latest

(See Installation for binary downloads).

Bake your Site

Locate your Obsidian vault folder using generate and preview it locally with serve:

# Generate the static website from your vault
kiln generate --input ./path-to-your-vault --output ./output-directory

# Preview your site locally
kiln serve ./output-directory

Open http://localhost:8080 to see your vault transformed into a website.

Features

Kiln is packed with features designed to bridge the gap between your personal knowledge base and a public-facing website.

Content & Rendering

We support the tools you use to think.

Obsidian Parity: Full support for Wikilinks, Callouts, and standard Markdown.
Interactive Canvas: Render .canvas files as zoomable, pan-able diagrams directly on your site.
Mermaid Graphs: Native support for flowcharts, sequence diagrams, and Gantt charts.
Math & LaTeX: Beautiful equation rendering via MathJax.
Syntax Highlighting: Automatic language detection and coloring for code blocks.

Your site behaves like a modern app, not a static document.

Instant Navigation: Powered by HTMX, pages load instantly without full refreshes (SPA feel).
File Explorer: A "What You See Is What You Get" sidebar that mirrors your vault structure.
Quick Find: Real-time, fuzzy search to filter your file tree instantly.
Table of Contents: Auto-generated right sidebar navigation for every note.

Visual Knowledge

Visualize how your ideas connect.

Global Graph: An interactive visualization of your entire vault's connections.
Local Graph: A context-aware network view specific to the current note.

Technical & SEO

Built for performance and discoverability.

Zero-Config SEO: Automatic generation of Meta Tags, Sitemap xml, and Robots.txt.
Theming: Built-in Light/Dark modes and customizable color palettes baked directly into CSS.

Deployment

The output of Kiln is a static website, which makes it really easy to deploy on your server. You can follow one of our guide for some popular services, like GitHub Pages, Vercel, Netlify or just one of the many Web Servers.

Contributing

Kiln is open source and distributed under the MIT License. If you spot a bug or have a feature request, please check our Roadmap or open an issue on GitHub.