Convert Markdown to premium-themed PDFs, slide decks (PPTX or PDF), styled HTML, and shareable links — from any AI coding agent.
This is the official skill for MarkPDF, built on the open Agent Skills standard. It works across Claude Code, Cursor, GitHub Copilot, VS Code, and the rest of the skills.sh ecosystem.
- 🏛 Hosted MCP — no toolchain on your machine. The agent calls
markpdf.app/mcpdirectly. No Python, no Chromium download, nopip install. - 🎨 15 designer themes, not generic dark/light. Notion-clean, McKinsey-corporate, academic, luxury, dark-mode, handwritten — picked by taste, not templates.
- 📊 Beyond PDF — slide decks (Marp, PDF or editable PPTX), styled HTML for previews, and revocable share links (
markpdf.app/d/<id>) with optional email gate, password, expiry. - 🧮 KaTeX + Mermaid + GFM out of the box.
- 🛡 MIT + free 2 exports/day instantly with a trial token. No signup.
Pick the flag that matches your agent:
npx skills add gausoft/markpdf-skill -a claude-code # Claude Code
npx skills add gausoft/markpdf-skill -a cursor # Cursor
npx skills add gausoft/markpdf-skill -a copilot # GitHub Copilot
npx skills add gausoft/markpdf-skill -a vscode # VS CodeSee skills.sh for the full list of supported agents.
Three commands, no signup, ~30 s. Restart Claude Code after step 3, then say "Make a PDF of this markdown".
# 1. Install the skill
npx skills add gausoft/markpdf-skill -a claude-code -y -g
# 2. Mint a free trial token (2 exports/day, no signup)
TOKEN=$(curl -sX POST https://markpdf.app/api/mcp/trial-token | jq -r .token)
# 3. Wire the MCP server into Claude Code
claude mcp add --transport http markpdf https://markpdf.app/mcp \
--header "Authorization: Bearer $TOKEN"🛟 Already have a token from before? Trial tokens are IP-rate-limited (one per 24 h) and shown only at issuance. If you lost yours, either wait for the cooldown or grab a Pro token at
markpdf.app/account/mcp— Pro starts at $5/mo or LTD $19.
The skill drives the MarkPDF MCP server. Setup snippets for Cursor, Claude Desktop, GitHub Copilot, VS Code, and others:
👉 https://markpdf.app/integrations/mcp
Pro keys (LTD $19) unlock unlimited exports + all 15 themes + custom fonts.
| When you ask… | The agent will… |
|---|---|
| "Make a PDF from this markdown" | Pick the right theme, render, generate a clean share link, deliver both |
| "Turn this into a pitch deck" | Use Marp slides + the aurora theme, return PDF or PPTX |
| "Share this with alice@example.com" | Email-gate the share link with magic-link auth |
| "Style it like a McKinsey report" | Pro theme consul (or fall back to paper on free tier) |
| "Use my brand color #ff5722" | Customize accent through customizations.accent |
| "Just give me the file" | Skip the share link, surface the direct download |
The skill bundles 8 reference recipes (academic paper, pitch deck, executive report, password-protected share, custom CSS, etc.) and OS-aware auto-open so the result lands directly in your browser.
After installing both the skill and the MCP server, here's a real session:
1. Install
# Add the MarkPDF MCP server (one-time)
claude mcp add --transport http markpdf https://markpdf.app/mcp \
--header "Authorization: Bearer mpf_trial_xxx" # get one at markpdf.app/integrations/mcp
# Add the skill
npx skills add gausoft/markpdf-skill -a claude-code2. Restart Claude Code, then drop a markdown file into the chat:
Take this
release-notes.mdand turn it into a polished PDF using the consul theme. Share it withalice@acme.comso she gets a magic link.
3. What Claude does behind the scenes:
1. whoami → tier=free, dailyUsed=0/2
2. convert_markdown_to_pdf → theme=consul, returns dl URL
3. create_share_link → kind=doc, accessEmails=[alice@acme.com]
4. open https://markpdf.app/d/x9k → auto-opens in your default browser
4. Output you see in the chat:
✅ PDF ready. Share link (1 click): https://markpdf.app/d/x9k7abc (Direct download if you need the file:
https://r2.markpdf.app/...) 🔒 Restricted — onlyalice@acme.comcan open it (magic link sent). Quota: 1/2 used today, 1 left (resets at 00:00 UTC).
The browser opens to the share page automatically. Alice gets the email.
The flow is identical for every agent — only the install commands and the chat UI change.
Cursor
npx skills add gausoft/markpdf-skill -a cursorAdd the MCP server to Cursor's settings (cmd+, → MCP) following https://markpdf.app/integrations/mcp#cursor. Then in any chat: "Make a PDF of this markdown using the consul theme."
GitHub Copilot
npx skills add gausoft/markpdf-skill -a copilotMCP setup: https://markpdf.app/integrations/mcp#copilot. The skill plugs into Copilot Chat — same prompts work.
VS Code
npx skills add gausoft/markpdf-skill -a vscodeMCP setup: https://markpdf.app/integrations/mcp#vscode. Use VS Code's Chat panel.
Other agents (~50 supported)
The skill conforms to the open Agent Skills standard. If your agent is on skills.sh, pass its slug to -a. Examples: aider, goose, continue, windsurf, zed.
| Tool | Purpose | Quota |
|---|---|---|
whoami |
Tier + remaining quota | Free |
list_themes |
Browse all available themes | Free |
redeem_license |
Upgrade a free token to Pro in-place | Free |
convert_markdown_to_html |
Iterate styling without burning quota | Free |
convert_markdown_to_pdf |
Final document export | Counts toward daily quota |
convert_markdown_to_slides |
Slide deck (PDF or PPTX) | Counts toward daily quota |
create_share_link |
Default delivery channel — clean markpdf.app/d/… URL |
Free |
A taste of what the skill produces. Free themes work with any token; Pro unlock with a license key (LTD $19).
 Paper · Free Editorial longform · Lora |
 Slate · Free Linear/Notion clean · Inter |
 Consul · Pro Corporate / consulting |
 Aurora · Pro Startup pitch · vibrant |
 Obsidian · Pro Luxury / premium dark |
 Midnight · Pro Dark mode tech / dev |
Plus ivory (free), scholar, hertz, folio, academic, quill, prose, rosepine, horizon. 15 themes total — see the full catalog or run list_themes from your agent.
markpdf-skill/
├── SKILL.md # Manifest + golden rules + variation playbook
├── references/ # On-demand docs (workflows, themes, slides, customization, frontmatter)
├── examples/ # Ready-to-render samples (academic, pitch-deck, report)
├── scripts/ # render.sh (curl fallback) + open-url.sh (OS-aware)
└── previews/ # Theme gallery PNGs (rendered from a deterministic sample)
Re-run the install command — skills add overwrites the existing copy with the latest from this repo:
npx skills add gausoft/markpdf-skill -a <your-agent>MIT — copyright © Gauthier Eholoum.
- 🌐 Web app: https://markpdf.app
- 📚 MCP setup: https://markpdf.app/integrations/mcp
- 🎨 Themes: https://markpdf.app/themes
- ⭐ Skill listing: https://skills.sh