English Français العربية

Docs MD — Markdown Share

Official registry Productivity

Share markdown as public links from your AI assistant — expiring or permanent, no API key.

Source code Website Documentation

What can you do with Docs MD — Markdown Share?

  • 📝 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http docs-md-markdown-share 'https://docs-md.com/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "docs-md-markdown-share": {
            "type": "http",
            "url": "https://docs-md.com/api/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Docs MD
  2. Demo: share a plan from Claude Code
  3. Features
  4. Public Pages
  5. API
  6. MCP Registry
  7. For AI agents
  8. MCP Setup
  9. Security Configuration
  10. Development
  11. Tech Stack
  12. License

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

Frequently asked questions

What is Docs MD — Markdown Share?

Share markdown as public links from your AI assistant — expiring or permanent, no API key.

How do I install Docs MD — Markdown Share?

It runs as a remote server. In Claude Code: claude mcp add --transport http docs-md-markdown-share 'https://docs-md.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Docs MD — Markdown Share need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Docs MD — Markdown Share open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Docs MD — Markdown Share?

It is published by invisible-hand. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.