Booklet

Publish clean, readable pages from Markdown — by hand, by script, or by your AI assistant.

Paste Markdown into the editor, preview it live, and share a polished read-only URL in one click — or skip the editor and publish the same way from a CI pipeline, a script, or an AI assistant like Claude. Sign in for pages that never expire, version history, analytics, custom slugs, password protection, collections, and a full REST API.

What makes Booklet more than an editor is the surface around it: a REST API, an npm-published CLI, a GitHub Action for publishing docs in CI, and a standalone MCP server so AI assistants like Claude can publish and manage pages directly. Markdown-to-shareable-page tools are common; shipping the same functionality as an API, a CLI, a CI action, and an MCP server on top of it is the part that isn't.

Live: booklet.ashwinsathian.com · API docs: /api-docs · MCP setup: /mcp-setup

---

Quick start

npm install -g booklet-cli
booklet login                            # opens your browser to authorize
booklet publish README.md --open         # publish this file, open it in your browser

That's it: you get back a permanent, shareable URL. No account needed to try the editor itself; sign in only when you want pages that never expire, an API key, or the CLI.

---

Features

• Editor: live preview (120 ms debounce), unlimited local drafts with autosave, import/export
• Share pages: clean read-only URLs, table of contents, reading time, dark/light mode
• Embeds: <iframe> embed codes for any page via /p/:id/embed
• Export: PDF, Markdown, HTML fragment
• LaTeX / KaTeX: inline $...$ and display $$...$$ math blocks
• Mermaid diagrams: fenced code blocks with mermaid language tag
• Version history: every publish is snapshotted; browse and restore past versions
• Analytics: per-page view counts, scroll depth, referrers
• Collections: group pages into a named collection with a shared URL
• Password protection: require a password to view any page
• Custom slugs: set a human-readable URL like /p/my-release-notes
• Team Spaces: invite collaborators, publish to shared /t/:slug spaces
• Webhooks: HTTP callbacks on page.published and page.updated events
• REST API: publish, update, list, and delete pages programmatically
• CLI: publish Markdown from your terminal (npx booklet-cli)
• GitHub Action: publish docs in CI via AshwinSathian/publish-to-booklet
• MCP server: expose the API to AI assistants (Claude, Cursor, etc.) via the Model Context Protocol

• Frontmatter: YAML frontmatter sets title, slug, visibility, tags, author, date

---

CLI

npm install -g booklet-cli

booklet login                          # save your API key
booklet publish README.md              # publish a file
booklet publish README.md --watch      # watch + auto-republish on save
booklet publish - < NOTES.md           # from stdin
booklet pages list                     # list your pages

See packages/cli/README.md for full docs (all flags, CI/non-interactive auth via --key or BOOKLET_API_KEY, pages open, etc.).

---

REST API