llms.txt
# Docs MD
> Docs MD (docs-md.com) shares Markdown documents as rendered links with an expiry you choose — no account needed — from the browser, from AI coding assistants through an MCP server, from scripts through a REST API, and from CI through a GitHub Action. It also hosts free browser-side markdown tools and syntax guides.
Shares are public URLs; an edit token returned at creation allows updates and deletion. Raw markdown for any share is at https://docs-md.com/raw/<id> (text/markdown). Limits: 120,000 characters per share, 20 shares per minute per IP.
## Product
- [Share Markdown online](https://docs-md.com/): Paste markdown, get a rendered link with Mermaid diagrams and an expiry (1, 7, 30 days or never). No signup.
- [About Docs MD](https://docs-md.com/about): What the service is, who runs it, what it stores.
- [REST API](https://docs-md.com/api-docs): POST /api/share to publish, PATCH/DELETE with an edit token, GET /raw/<id> for the markdown. Includes a GitHub Actions recipe.
- [GitHub Action](https://docs-md.com/github-action): uses: invisible-hand/share-markdown-action@v1 — publish a markdown file from a workflow and get the URL as a step output.
- [MCP server](https://docs-md.com/what-is-mcp): share_markdown, update_share and delete_share tools at https://docs-md.com/api/mcp for Claude Code, Cursor and other MCP clients.
- [Share Markdown from Cursor and Claude with MCP](https://docs-md.com/ai-powered-ide): Per-editor setup for the MCP server.
- [Use cases](https://docs-md.com/use-cases): When a shared markdown link beats a repo, a gist or a chat paste.
- [Share markdown without an account: services compared](https://docs-md.com/share-markdown-without-account): Docs MD vs Rentry, yeet.md, HackMD, HedgeDoc, JotBird, dochost, boomurl on account, link lifetime, editing, Mermaid and API.
## Walkthroughs with example documents
- [Share an implementation plan for review](https://docs-md.com/share-implementation-plan): Template, filled-in example and the MCP prompt.
- [Agent handoff document](https://docs-md.com/agent-handoff-document): Nine-section template for passing a coding task between AI agents, with a worked example.
- [Share an architecture diagram with notes](https://docs-md.com/share-architecture-diagram): Mermaid diagram plus decisions in one shareable document.
- [Bug report template](https://docs-md.com/bug-report-template): Markdown template, filled-in example and the GitHub issue-form YAML.
## Free markdown tools
### Convert
- [HTML to markdown converter](https://docs-md.com/html-to-markdown): Paste HTML or rich text from any web page and get clean GitHub-flavored markdown — tables, code blocks, and nested lists included.
- [Markdown to HTML converter](https://docs-md.com/markdown-to-html): Turn markdown into clean semantic HTML as you type — copy the fragment, or download a complete styled document. GFM supported.
- [Markdown to PDF converter](https://docs-md.com/markdown-to-pdf): Paste or open a .md file and download a PDF with real selectable text, highlighted code, and rendered tables. Fully client-side.
- [PDF to markdown converter](https://docs-md.com/pdf-to-markdown): Drop a PDF, get editable markdown — headings, lists, and paragraphs inferred from the layout. Nothing is uploaded.
- [Markdown to Word converter](https://docs-md.com/markdown-to-word): Markdown to a .doc that opens in Word — or paste from Word and get clean markdown back. Both directions, in-browser.
- [CSV to markdown table converter](https://docs-md.com/csv-to-markdown): Paste CSV, TSV, or a spreadsheet range and get an aligned markdown table — or paste a markdown table and get CSV back.
### Generate
- [Markdown table generator](https://docs-md.com/markdown-table-generator): Build tables in a visual grid — set column alignment, paste CSV/TSV from a spreadsheet, and copy clean padded markdown.
- [README generator](https://docs-md.com/readme-generator): Fill in a form, get a professional README.md with live badges, install and usage sections, and a live preview.
- [Table of contents generator](https://docs-md.com/markdown-toc-generator): Paste a document, get a linked TOC with GitHub-exact anchor slugs — choose depth, insert it under your title.
- [Link, image & code block generator](https://docs-md.com/markdown-link-generator): Fill in a form, get correct markdown for links (with tooltips and reference style), sized images, and fenced code.
- [Markdown badge generator](https://docs-md.com/markdown-badge-generator): Design shields.io badges with a live preview — label, message, color, style, logo — and copy them as markdown, HTML, or reStructuredText.
- [Changelog generator](https://docs-md.com/changelog-generator): Build a CHANGELOG.md in Keep a Changelog format — or paste your git log and let conventional commits sort themselves into Added, Fixed, and Changed.
- [Front matter generator](https://docs-md.com/front-matter-generator): Generate valid YAML, TOML, or JSON front matter for Jekyll, Hugo, Astro, Docusaurus, or Obsidian — dates, tags, slugs, and custom fields, escaped correctly.
### Check & compare
- [Markdown linter](https://docs-md.com/markdown-lint): Find heading, list, spacing, and link problems in a document — every finding explained, most of them fixable with one click.
- [Markdown diff checker](https://docs-md.com/markdown-diff): Compare two versions of a document side by side or as a unified patch, with word-level highlights inside changed lines.
- [Markdown link checker](https://docs-md.com/markdown-link-checker): Extract every link from a document and check it — dead pages, redirects, and broken #anchors — with the line each one is on.
- [Markdown word counter](https://docs-md.com/markdown-word-counter): Word, character, sentence, and paragraph counts that ignore markdown syntax and code — plus reading time and heading, link, and image totals.
### Edit & share
- [GitHub README and docs viewer](https://docs-md.com/github-readme-viewer): Paste a repository URL and read its README and docs folder as a clean, linked site — relative links and images resolved, no cloning.
- [Markdown viewer](https://docs-md.com/markdown-viewer): Open a .md file — drag it in, paste, or load from a URL — and read it rendered with tables, code highlighting, and mermaid diagrams. Print or share it.
- [Markdown formatter](https://docs-md.com/markdown-formatter): Prettify messy markdown: uniform list markers, one emphasis style, aligned tables. Semantic — rendered output never changes.
### Reference
- [Markdown cheat sheet](https://docs-md.com/markdown-cheat-sheet): Every element of markdown and GFM with side-by-side syntax and rendered output — headings to footnotes to mermaid diagrams.
## Learn markdown
- [Markdown cheat sheet](https://docs-md.com/markdown-cheat-sheet): Every syntax element with examples, GFM extensions included.
- [Markdown syntax guides](https://docs-md.com/guides): One page per question: checkboxes, strikethrough, underline, quotes, images, links, code blocks, comments, indentation, line breaks, centering.
- [What is Markdown?](https://docs-md.com/what-is-markdown): Plain-text formatting explained for people who have never used it.
- [README templates](https://docs-md.com/readme-templates): Copyable README templates for libraries, apps, CLIs and data projects.
- [Discord markdown](https://docs-md.com/discord-markdown): What Discord renders and what it does not.
- [Slack formatting](https://docs-md.com/slack-markdown): Slack's mrkdwn versus real markdown.
- [Mermaid timeline examples](https://docs-md.com/mermaid-timeline-examples): Timeline syntax with rendered examples.
- [What is an MCP server?](https://docs-md.com/what-is-an-mcp-server): The Model Context Protocol explained.
- [MCP server list](https://docs-md.com/mcp-servers): Public MCP servers worth knowing.
### Syntax guides
- [How to make text bold or italic in markdown](https://docs-md.com/guides/markdown-bold-italic): Bold is **text** or __text__, italic is *text* or _text_, bold italic is ***text***. Nesting, the mid-word underscore trap, escaping, and the Slack, Discord and WhatsApp differences.
- [Markdown bullet points: how to make a bullet list](https://docs-md.com/guides/markdown-bullet-points): Markdown bullet points: start a line with -, * or + and a space. Nested bullets, tight vs loose lists, bullets inside quotes and tables, and why a list does not render.
- [How to center text in markdown](https://docs-md.com/guides/markdown-center-text): Markdown has no centering syntax. Use <div align="center"> or <p align="center"> where HTML is allowed, like GitHub READMEs. Center images, headings.
- [How to make a checkbox in markdown](https://docs-md.com/guides/markdown-checkbox): Create checkboxes in markdown with - [ ] for unchecked and - [x] for checked. Task list syntax for GitHub, GitLab, Obsidian, Discord, nesting and gotchas.
- [How to write a code block in markdown](https://docs-md.com/guides/markdown-code-block): Make code blocks with triple-backtick fences and a language tag for syntax highlighting. Inline code, escaping backticks, nested fences, diff highlighting.
- [Markdown collapsible section: how to hide and expand text](https://docs-md.com/guides/markdown-collapsible-section): Markdown collapsible section: wrap content in <details><summary> for an expandable block on GitHub and GitLab. Open by default, nesting, code inside, Obsidian folds, Notion toggles.
- [Markdown color text: how to change the color of text](https://docs-md.com/guides/markdown-color-text): Markdown has no color syntax. Use <span style> where HTML is allowed, the math color trick or diff blocks on GitHub, Discord ANSI code blocks, Obsidian and Notion options.
- [How to write a comment in markdown](https://docs-md.com/guides/markdown-comment): Markdown has no comment syntax, but HTML comments <!-- like this --> stay hidden in rendered output. Where they leak, and truly invisible alternatives.
- [Markdown escape characters: how to show * _ # and | literally](https://docs-md.com/guides/markdown-escape-characters): Markdown escape characters: put a backslash before a symbol to show it literally. Full CommonMark escape list, escaping pipes in tables, backticks, < and >, HTML entities, Discord and Slack.
- [Markdown footnotes: how to add a footnote](https://docs-md.com/guides/markdown-footnotes): Markdown footnote syntax: [^1] in the text and [^1]: note at the bottom. Inline ^[note] footnotes, multi-paragraph notes, numbering and which apps support them.
- [How to make headings in markdown](https://docs-md.com/guides/markdown-headings): Make a heading with # for H1 through ###### for H6, a space after the hashes. Anchor links, the one-H1 rule, setext underlines, and where headings break in GitHub, Discord, Slack and Obsidian.
- [Markdown horizontal rule: how to add a divider line](https://docs-md.com/guides/markdown-horizontal-rule): Markdown horizontal rule syntax: three or more hyphens, asterisks or underscores on a line of their own. Fix the --- heading and front matter pitfall, spacing and styling.
- [How to add an image in markdown](https://docs-md.com/guides/markdown-image): Embed images in markdown with . Local paths vs URLs, image links, sizing with HTML width attributes, captions, and GitHub-specific tips.
- [How to indent in markdown](https://docs-md.com/guides/markdown-indent): Indentation in markdown is syntax, not styling: 2 spaces nests lists, 4 spaces makes a code block. Indent paragraphs, continue list items, avoid tabs.
- [Markdown links: how to add a hyperlink in markdown](https://docs-md.com/guides/markdown-link): Markdown link syntax: [text](url) makes a hyperlink. Reference-style links, autolinks, relative links, links to headings, image links, titles, escaping, fixes.
- [Markdown math: how to write equations with $ and $$](https://docs-md.com/guides/markdown-math): Markdown math syntax: $x^2$ for inline and $$ blocks for display equations, plus GitHub math fences. Support in GitHub, GitLab, Obsidian, Typora, Jupyter, with LaTeX examples.
- [How to make a new line in markdown](https://docs-md.com/guides/markdown-new-line): Single newlines collapse in markdown. Force a line break with two trailing spaces or a backslash, or leave a blank line for a new paragraph. Renderer tips.
- [Markdown page break: how to start a new page in PDF and Word](https://docs-md.com/guides/markdown-page-break): Markdown has no page break syntax. Use <div style="page-break-after: always"> for HTML and PDF export, \newpage in Pandoc, or editor options. Why --- is not a page break.
- [Markdown blockquote: how to quote text in markdown](https://docs-md.com/guides/markdown-quote): Markdown blockquote syntax: start a line with > to quote text. Multi-line, nested and cited quotes, author attribution, code in quotes, Discord and Slack quotes, callouts.
- [How to strikethrough text in markdown](https://docs-md.com/guides/markdown-strikethrough): Cross out text in markdown by wrapping it in double tildes, like ~~this~~. Where it works (GitHub, Discord, Slack), single vs double tilde, HTML fallbacks.
- [Markdown subscript: how to write text below the line](https://docs-md.com/guides/markdown-subscript): Markdown subscript syntax: <sub>text</sub> on GitHub, ~text~ in Pandoc and Typora, Unicode H₂O in chat apps. Why ~ clashes with strikethrough, with a support table.
- [Markdown superscript: how to write text above the line](https://docs-md.com/guides/markdown-superscript): Markdown superscript syntax: ^text^ in Pandoc and Typora, <sup>text</sup> on GitHub and GitLab, Unicode ² characters in chat apps. Support table and fixes.
- [How to underline text in markdown](https://docs-md.com/guides/markdown-underline): Markdown has no underline syntax; underscores make italics. Use HTML <u> or <ins> tags where allowed, and see what works on GitHub, Discord, and Slack.
## Optional
- [Sitemap](https://docs-md.com/sitemap.xml): every indexable URL
- [Source](https://github.com/invisible-hand/docs-md.com): public repository with the site; the GitHub Action lives at https://github.com/invisible-hand/share-markdown-action
