Welcome
markdown-publish turns a folder of notes (an Obsidian vault or just plain Markdown) into a fast static site — like the one you're looking at. This site itself was built with it from regular .md files.
Want a site like this in a couple of clicks?
Open In a Couple of Clicks — three buttons, and the rest happens by itself.
What it can do
- Search — instant, runs right in your browser (press
Ctrl+K). - Link Graph — an interactive map of your notes, just like in Obsidian (the "Graph view" link on the left).
- Canvas Boards —
.canvasfiles render as interactive boards: here's a live example. - AI agents — the site serves your notes to AI agents via WebMCP.
[[wikilinks]], regular markdown links, embeds, callouts, tags, footnotes, code highlighting.- Dark/light theme, mobile version, note previews when you hover over a link.
- SEO out of the box: sitemap, robots.txt, llms.txt, OG cards, JSON-LD.
- Cyrillic in page URLs — the Russian version of this site is a live example.
How to publish your notes
| Path | Difficulty | Guide |
|---|---|---|
| Netlify / Vercel button | 2 clicks | In a Couple of Clicks |
| Your existing vault → GitHub | 10 minutes, no terminal | Your Existing Vault on GitHub |
| Template + GitHub Pages | 3–4 clicks | GitHub Pages |
| Your own repo + workflow | for those who know git | GitHub Pages |
| Cloudflare Pages | a couple of minutes | Cloudflare Pages |
| Locally via the CLI | terminal | CLI |
Published? Next stop — How to Update the Site. All the settings (site name, language, which notes to publish) live in Configuration.
Where's the code
The project is open source (MIT): github.com/abstractwebunit/markdown-publish. Not affiliated with Obsidian.MD — it simply reads compatible vaults.