Docs MD — Markdown Share

Docs MD

免费在线分享 Markdown，无需注册。 粘贴 Markdown 文件，即可获得渲染后的链接，支持 Mermaid 图表、代码高亮，并可选择过期时间（1、7、30 天或永不过期）。可通过浏览器访问 docs-md.com 分享，也可通过 MCP 服务从 Cursor 或 Claude Code 分享，或通过 REST API 使用脚本分享。分享链接为公开 URL；编辑令牌可让你原地更新或删除分享内容。

附带可下载文档的示例：分享实施计划以征求评审意见 · Agent 交接文档 · 附带说明的架构图 · 无账号分享服务对比。

演示：从 Claude Code 分享计划

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

然后，在打开计划后：

发布 implementation-plan.md，设置 7 天后过期。给我阅读链接，并确保编辑令牌不会出现在文档中。

助手会调用 share_markdown，并返回渲染后的 URL、原始 URL、过期日期和编辑令牌。之后，“用新计划更新分享内容”会调用 update_share——链接不变，内容更新。

功能

• 📝 即时分享 - 粘贴 Markdown，即可获得可分享的链接
• 👀 实时预览 - 发布前并排编写和预览
• ⏰ 灵活的过期时间 - 默认 30 天；也可设置为 1 天、7 天或永不过期
• ✏️ 编辑与删除 - 每次分享都会返回一个私有编辑令牌
• 🧜 Mermaid 图表 - ```mermaid 代码块会渲染为图表
• 📑 目录 - 为长文档自动生成侧边栏
• 🔗 原始内容端点 + API - GET /raw/:id，完整 REST API 见 /api-docs
• 🔌 MCP 集成 - share_markdown、update_share、delete_share 工具
• 📚 指南和工具 - 关于、什么是 MCP、AI IDE 指南、使用场景、API 文档、示例、21 个免费 Markdown 工具
• 🔐 安全默认设置 - 验证、负载限制、速率限制和受保护的运维端点

公共页面

• / - Markdown 编辑器 + 实时预览
• /about - 产品概览
• /what-is-mcp - MCP 介绍
• /ai-powered-ide - AI IDE 工作流指南
• /use-cases - 常见使用模式
• /api-docs - REST API 文档（包含 GitHub Actions 发布示例）
• /github-action - 可复用的 GitHub Action（uses: invisible-hand/share-markdown-action@v1，源代码位于 github.com/invisible-hand/share-markdown-action）
• /llms.txt - 面向 AI 爬虫的公共页面机器可读索引
• /share-implementation-plan、/agent-handoff-document、/share-architecture-diagram、/bug-report-template - 附带示例文档的操作指南（content/examples/*.md，通过 /examples/<slug>/raw 提供）
• /share-markdown-without-account - 无需注册的 Markdown 分享服务对比
• /tools - 免费 Markdown 工具；/guides - 语法指南
• /sitemap.xml 和 /robots.txt

API

请参阅 docs-md.com/api-docs。摘要：

• POST /api/share — 请求体 {content, filename?, expiry?}，其中 expiry ∈ 1d|7d|30d|never；返回 {id, url, rawUrl, editToken, expiresAt}（expiresAt 为 0 表示永久）
• PATCH /api/share/:id — 请求头 x-edit-token，请求体 {content, filename?}
• DELETE /api/share/:id — 请求头 x-edit-token
• GET /raw/:id — 原始 text/markdown

索引策略：只有永久分享内容可被索引；过期分享会以 noindex 提供（这是对搜索引擎的请求，并非保证）。所有分享内容对任何拥有链接的人公开；过期后会删除对应 URL 上的页面，但无法撤回已下载的副本。

MCP Registry

已发布到官方 MCP Registry，名称为 com.docs-md/markdown-share——远程流式 HTTP 服务，地址为 https://docs-md.com/api/mcp，提供 share_markdown、update_share 和 delete_share 工具。

面向 AI Agent

• 一行命令：curl --data-binary @PLAN.md "https://docs-md.com/api/share?expiry=7d"

• 以 Markdown 格式读取任意分享内容：https://docs-md.com/<id>.md

• Claude Code 插件（MCP 服务 + 技能）：

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

• 其他所有内容（适用于所有 MCP 客户端、AGENTS.md 片段、OpenAPI）：https://docs-md.com/agents

MCP 设置

远程流式 HTTP 服务，无需 API 密钥。各编辑器（Cursor、Claude Code、VS Code、Windsurf、Zed）的配置见 docs-md.com/ai-powered-ide。Cursor 的配置文件位于 ~/.cursor/mcp.json 或项目的 .cursor/mcp.json：

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

重启 Cursor，然后说：“分享此 Markdown 文件，设置 7 天有效期”。

安全配置

在生产环境中设置这些环境变量：

# 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

开发

# Install
npm install

# Run dev server
npm run dev

# Type check
npm run type-check

# Lint
npm run lint

# Build
npm run build

技术栈

• Next.js 16、TypeScript、Tailwind CSS
• Neon Postgres + Vercel Blob
• Model Context Protocol（MCP）
• Zod 请求验证

许可证

MIT