In a Couple of Clicks
The fastest path from "a folder of notes" to "a site on the internet". Nothing to install.
Option 1 — the Netlify button (the simplest)
- Press the button → sign in with GitHub (free).
- Netlify creates a copy of the template in your GitHub by itself and builds the site.
- A couple of minutes later the site lives at
name.netlify.app.
From then on you just put your .md files into the vault/ folder of your new repository — the site rebuilds itself on every change.
Option 2 — the Vercel button
The same thing, but on Vercel: button → sign in with GitHub → the site at name.vercel.app.
Option 3 — template + GitHub Pages (no third-party services)
All you need is a GitHub account. Detailed steps: GitHub Pages.
What's inside the template
The markdown-publish-template repository is:
vault/— your notes (a few starter ones are already there);markdown-publish.config.json— the site settings (Configuration);- ready-made configs for GitHub Pages, Netlify and Vercel — that's why the buttons just work.
Your notes are already in a repository?
Then you don't need the template — add the workflow to your own repository: GitHub Pages.
What's next
The site is up — now see How to Update the Site: how to add notes (from the browser or from Obsidian) and how to rename the site and the repository from a random name into something human.