Docs MD — Markdown Share

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 share_markdown and returns the rendered URL, the raw URL, the expiry date, and the edit token. Later, "update the share with the new plan" calls update_share — 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 - share_markdown, update_share, 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/<slug>/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 share_markdown, update_share, and delete_share.

For AI agents

• One line: curl --data-binary @PLAN.md "https://docs-md.com/api/share?expiry=7d"

• Read any share as markdown: https://docs-md.com/<id>.md

• Claude Code plugin (MCP server + skill):

  /plugin install docs-md --marketplace invisible-hand/docs-md.com
  

• Everything else (every MCP client, AGENTS.md snippet, OpenAPI): https://docs-md.com/agents

MCP Setup

Remote streamable-HTTP server, no API key. Per-editor configs (Cursor, Claude Code, VS Code, Windsurf, Zed) are on docs-md.com/ai-powered-ide. Cursor, in ~/.cursor/mcp.json or the project's .cursor/mcp.json:

{
  "mcpServers": {
    "md-share": {
      "url": "https://docs-md.com/api/mcp"
    }
  }
}

Restart Cursor, then say: "Share this markdown file with a 7-day expiry".

Security Configuration

Set these environment variables in production:

# API body limits
MAX_SHARE_REQUEST_BYTES=200000
MAX_MCP_REQUEST_BYTES=250000
MAX_MARKDOWN_CHARS=120000

# Rate limiting (per IP, per window)
RATE_LIMIT_WINDOW_MS=60000
RATE_LIMIT_SHARE_PER_WINDOW=20
RATE_LIMIT_MCP_PER_WINDOW=30

# Protected endpoints
CRON_SECRET=your-cleanup-secret
ADMIN_API_SECRET=your-admin-secret

# Optional CORS allowlist for MCP preflight
MCP_ALLOWED_ORIGINS=https://docs-md.com,http://localhost:3000

Development

# Install
npm install

# Run dev server
npm run dev

# Type check
npm run type-check

# Lint
npm run lint

# Build
npm run build

Tech Stack

• Next.js 16, TypeScript, Tailwind CSS
• Neon Postgres + Vercel Blob
• Model Context Protocol (MCP)
• Zod request validation

License

MIT