{
  "markdown": "# Docs MD\n\n**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](https://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.\n\nWorked examples with downloadable documents: [share an implementation plan for review](https://docs-md.com/share-implementation-plan) · [agent handoff document](https://docs-md.com/agent-handoff-document) · [architecture diagram with notes](https://docs-md.com/share-architecture-diagram) · [no-account sharing services compared](https://docs-md.com/share-markdown-without-account).\n\n## Demo: share a plan from Claude Code\n\n```bash\nclaude mcp add --transport http md-share https://docs-md.com/api/mcp\n```\n\nThen, with a plan open:\n\n> Publish implementation-plan.md with a 7-day expiry. Give me the reading link and keep the edit token out of the document.\n\nThe 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.\n\n## Features\n\n- 📝 **Instant Sharing** - Paste markdown, get a shareable link\n- 👀 **Live Preview** - Write and preview side-by-side before publishing\n- ⏰ **Flexible Expiry** - 30 days by default; 1 day, 7 days, or never\n- ✏️ **Edit & Delete** - Every share returns a private edit token\n- 🧜 **Mermaid Diagrams** - ` ```mermaid ` code blocks render as diagrams\n- 📑 **Table of Contents** - Auto-generated sidebar for long documents\n- 🔗 **Raw Endpoint + API** - `GET /raw/:id`, full REST API at `/api-docs`\n- 🔌 **MCP Integration** - `share_markdown`, `update_share`, `delete_share` tools\n- 📚 **Guides and tools** - About, What is MCP, AI IDE guide, use cases, API docs, worked examples, 21 free markdown tools\n- 🔐 **Security Defaults** - Validation, payload limits, rate limiting, and protected ops endpoints\n\n## Public Pages\n\n- `/` - Markdown editor + live preview\n- `/about` - Product overview\n- `/what-is-mcp` - MCP explainer\n- `/ai-powered-ide` - AI IDE workflow guide\n- `/use-cases` - Common usage patterns\n- `/api-docs` - REST API documentation (includes a GitHub Actions publishing recipe)\n- `/github-action` - the reusable GitHub Action (`uses: invisible-hand/share-markdown-action@v1`, source at github.com/invisible-hand/share-markdown-action)\n- `/llms.txt` - machine-readable index of the public pages for AI crawlers\n- `/share-implementation-plan`, `/agent-handoff-document`, `/share-architecture-diagram`, `/bug-report-template` - walkthroughs with example documents (`content/examples/*.md`, served at `/examples/<slug>/raw`)\n- `/share-markdown-without-account` - comparison of no-signup markdown sharing services\n- `/tools` - free markdown tools; `/guides` - syntax guides\n- `/sitemap.xml` and `/robots.txt`\n\n## API\n\nSee [docs-md.com/api-docs](https://docs-md.com/api-docs). Summary:\n\n- `POST /api/share` — body `{content, filename?, expiry?}` where expiry ∈ `1d|7d|30d|never`; returns `{id, url, rawUrl, editToken, expiresAt}` (expiresAt `0` = permanent)\n- `PATCH /api/share/:id` — header `x-edit-token`, body `{content, filename?}`\n- `DELETE /api/share/:id` — header `x-edit-token`\n- `GET /raw/:id` — raw `text/markdown`\n\nIndexing 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.\n\n## MCP Registry\n\nPublished in the [official MCP Registry](https://registry.modelcontextprotocol.io) 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`.\n\n## MCP Setup\n\nRemote streamable-HTTP server, no API key. Per-editor configs (Cursor, Claude Code, VS Code, Windsurf, Zed) are on [docs-md.com/ai-powered-ide](https://docs-md.com/ai-powered-ide). Cursor, in `~/.cursor/mcp.json` or the project's `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"md-share\": {\n      \"url\": \"https://docs-md.com/api/mcp\"\n    }\n  }\n}\n```\n\nRestart Cursor, then say: \"Share this markdown file with a 7-day expiry\".\n\n## Security Configuration\n\nSet these environment variables in production:\n\n```bash\n# API body limits\nMAX_SHARE_REQUEST_BYTES=200000\nMAX_MCP_REQUEST_BYTES=250000\nMAX_MARKDOWN_CHARS=120000\n\n# Rate limiting (per IP, per window)\nRATE_LIMIT_WINDOW_MS=60000\nRATE_LIMIT_SHARE_PER_WINDOW=20\nRATE_LIMIT_MCP_PER_WINDOW=30\n\n# Protected endpoints\nCRON_SECRET=your-cleanup-secret\nADMIN_API_SECRET=your-admin-secret\n\n# Optional CORS allowlist for MCP preflight\nMCP_ALLOWED_ORIGINS=https://docs-md.com,http://localhost:3000\n```\n\n## Development\n\n```bash\n# Install\nnpm install\n\n# Run dev server\nnpm run dev\n\n# Type check\nnpm run type-check\n\n# Lint\nnpm run lint\n\n# Build\nnpm run build\n```\n\n## Tech Stack\n\n- Next.js 16, TypeScript, Tailwind CSS\n- Neon Postgres + Vercel Blob\n- Model Context Protocol (MCP)\n- Zod request validation\n\n## License\n\nMIT\n",
  "bytes": 5234,
  "sha": "52cae21f26b066b6d68547f19ce550d5780dc1e786656d0a92bdb22d08e74127",
  "repo_slug": "invisible-hand/docs-md.com",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_docs_md_markdown_share_0c54a645/readme"
}