Quickstart
Get your first Notion page converted to Markdown in under 2 minutes.
Export from Notion
Open any Notion page, click the ... menu in the top-right corner, choose Export, and select HTML as the format.
For best results, export individual pages rather than entire workspaces. Workspace exports create ZIP files which require a paid plan.
Upload your file
Drag and drop the .html file into the converter on the home page. You can also paste raw HTML directly into the editor.
Copy or export
Click Convert to see the clean Markdown output. Use the Copy button to grab it, or sign in to export directly to Google Docs.
Using the npm library
If you prefer to convert programmatically, install the library:
npm install @kami/html-to-mdThen use it in your code:
import { notionHtmlToMarkdown } from "@kami/html-to-md";
const html = fs.readFileSync("export.html", "utf-8");
const markdown = notionHtmlToMarkdown(html);
console.log(markdown);Runtime compatibility
The converter uses a SAX parser (no DOM) and works in Node.js, Cloudflare Workers, Deno, Bun, and any JavaScript runtime.
Using the API
For server-to-server workflows, use the REST API:
curl -X POST https://kami.typo.monster/api/v1/convert \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-F "file=@export.html"See the API Reference for full details.
Next steps
- Supported blocks — see which Notion blocks are converted
- Plans & limits — understand usage quotas
- API Reference — programmatic access