Docs MD — Markdown Share MCP server

Docs MD

Share Markdown online for free — no signup. Paste a Markdown file and get a rendered link with Mermaid diagrams, highlighted code, and an expiry you choose (1, 7, 30 days, or never). Share from the browser at docs-md.com, from Cursor or Claude Code through the MCP server, or from scripts with the REST API. Shares are public URLs; an edit token lets you update or delete them in place.

Worked examples with downloadable documents: share an implementation plan for review · agent handoff document · architecture diagram with notes · no-account sharing services compared.

Demo: share a plan from Claude Code

claude mcp add --transport http md-share https://docs-md.com/api/mcp

Then, with a plan open:

Publish implementation-plan.md with a 7-day expiry. Give me the reading link and keep the edit token out of the document.

The assistant calls sharemarkdown and returns the rendered URL, the raw URL, the expiry date, and the edit token. Later, "update the share with the new plan" calls updateshare — same link, new content.

Features

• 📝 Instant Sharing - Paste markdown, get a shareable link
• 👀 Live Preview - Write and preview side-by-side before publishing
• ⏰ Flexible Expiry - 30 days by default; 1 day, 7 days, or never
• ✏️ Edit & Delete - Every share returns a private edit token
• 🧜 Mermaid Diagrams - mermaid code blocks render as diagrams
• 📑 Table of Contents - Auto-generated sidebar for long documents
• 🔗 Raw Endpoint + API - GET /raw/:id, full REST API at /api-docs
• 🔌 MCP Integration - sharemarkdown, updateshare, delete_share tools
• 📚 Guides and tools - About, What is MCP, AI IDE guide, use cases, API docs, worked examples, 21 free markdown tools
• 🔐 Security Defaults - Validation, payload limits, rate limiting, and protected ops endpoints

Public Pages

• / - Markdown editor + live preview
• /about - Product overview
• /what-is-mcp - MCP explainer
• /ai-powered-ide - AI IDE workflow guide
• /use-cases - Common usage patterns
• /api-docs - REST API documentation (includes a GitHub Actions publishing recipe)
• /github-action - the reusable GitHub Action (uses: invisible-hand/share-markdown-action@v1, source at github.com/invisible-hand/share-markdown-action)
• /llms.txt - machine-readable index of the public pages for AI crawlers
• /share-implementation-plan, /agent-handoff-document, /share-architecture-diagram, /bug-report-template - walkthroughs with example documents (content/examples/*.md, served at /examples//raw)
• /share-markdown-without-account - comparison of no-signup markdown sharing services
• /tools - free markdown tools; /guides - syntax guides
• /sitemap.xml and /robots.txt

API

See docs-md.com/api-docs. Summary:

• POST /api/share — body {content, filename?, expiry?} where expiry ∈ 1d|7d|30d|never; returns {id, url, rawUrl, editToken, expiresAt} (expiresAt 0 = permanent)
• PATCH /api/share/:id — header x-edit-token, body {content, filename?}
• DELETE /api/share/:id — header x-edit-token
• GET /raw/:id — raw text/markdown

Indexing policy: only permanent shares are indexable; expiring shares are served with noindex (a request to search engines, not a guarantee). All shares are public to anyone with the link; expiry deletes the page at its URL but cannot recall downloaded copies.

MCP Registry

Published in the official MCP Registry as com.docs-md/markdown-share — remote streamable-HTTP server at https://docs-md.com/api/mcp with tools sharemarkdown, updateshare, and delete_share.

MCP Setup

Shortened. The full README is on GitHub.