# 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/ (text/markdown). Limits: 120,000 characters per share, 20 shares per minute and 100 per day per IP. Agents: publish with `curl --data-binary @FILE.md "https://docs-md.com/api/share?expiry=7d"` (plain-text reply, URL on the first line); read any share as markdown at https://docs-md.com/.md. ## 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. - [Docs MD for AI agents](https://docs-md.com/agents): Publish markdown from any agent in one curl line, read any share as markdown (/.md), MCP setup for every client, a Claude Code plugin and skill, an AGENTS.md snippet. - [REST API](https://docs-md.com/api-docs): POST /api/share to publish, PATCH/DELETE with an edit token, GET /raw/ 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, read_share, 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. - [How do I copy a web page as Markdown?](https://docs-md.com/html-to-markdown/copy-web-page-as-markdown): Select the text, copy, and paste into an HTML-to-markdown converter. Or use a browser extension, a reader service, or a short Node script. - [How do I convert a Google Doc to Markdown?](https://docs-md.com/html-to-markdown/google-docs-to-markdown): Turn on Enable Markdown, then use File, Download, Markdown (.md) or right-click, Copy as Markdown. Other routes: paste into a converter, or pandoc. - [Why convert HTML to Markdown before sending it to an LLM?](https://docs-md.com/html-to-markdown/html-to-markdown-for-llm): Markdown keeps headings, lists, links and tables but drops tags, scripts and styling, so the same page costs far fewer tokens. A measured example. - [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. - [Is converting Markdown to HTML safe from XSS?](https://docs-md.com/markdown-to-html/is-markdown-html-safe): Markdown converters are not sanitizers. Raw HTML and javascript: links pass through most of them. What to sanitize, where, and with which library. - [Can I use Markdown in email?](https://docs-md.com/markdown-to-html/markdown-in-email): Not directly: email clients render HTML or plain text, not Markdown. Write in Markdown, convert to HTML, then paste or send the HTML. Steps and pitfalls. - [How do I convert Markdown to HTML in JavaScript?](https://docs-md.com/markdown-to-html/markdown-to-html-javascript): Install a parser such as marked or markdown-it and call it on your string. Tested code for Node and the browser, how the libraries differ, and sanitizing. - [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. - [How do I convert a Markdown table to PDF?](https://docs-md.com/markdown-to-pdf/markdown-table-to-pdf): Paste the table into a converter that renders pipe tables, check the preview, save as PDF. Steps, wide-table fixes, and what breaks. - [How do I keep Mermaid diagrams and code blocks when converting Markdown to PDF?](https://docs-md.com/markdown-to-pdf/markdown-to-pdf-mermaid-code): Use a converter that renders mermaid fences and highlights code, or pre-render diagrams for Pandoc. What survives, what gets cut off, and fixes. - [How do I export Markdown to PDF from VS Code?](https://docs-md.com/markdown-to-pdf/vs-code-markdown-to-pdf): VS Code previews markdown but has no PDF export. Three ways that work: the Markdown PDF extension, a browser converter, or Pandoc in the terminal. - [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. - [How do I convert PDF tables to Markdown tables?](https://docs-md.com/pdf-to-markdown/pdf-tables-to-markdown): Extract the table with a table-aware tool such as Tabula, Camelot or pdfplumber, export CSV, convert it to a pipe table, then check the cells. - [How do I convert a PDF to Markdown for ChatGPT, Claude or a RAG pipeline?](https://docs-md.com/pdf-to-markdown/pdf-to-markdown-for-llm): Extract the PDF's text layer as markdown, clean headers and page numbers, then paste, upload or chunk it by heading. When to send the PDF itself instead. - [Can a scanned PDF be converted to Markdown?](https://docs-md.com/pdf-to-markdown/scanned-pdf-to-markdown): Yes, after OCR adds a text layer. How to tell if a PDF is scanned, how to run OCR with OCRmyPDF, then convert, and what OCR gets wrong. - [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. - [Can Microsoft Word open a .md file?](https://docs-md.com/markdown-to-word/can-word-open-md-file): Word has no Markdown reader. Desktop Word shows a .md file as plain text; Word for the web will not open it. How to get a formatted Word document. - [How do I keep code blocks formatted when converting Markdown to Word?](https://docs-md.com/markdown-to-word/keep-code-blocks-in-word): Convert with a tool that maps fenced code to a monospaced block style, tag the language for highlighting, and stop Word's AutoCorrect from changing quotes. - [How do I turn a Markdown table into a Word table?](https://docs-md.com/markdown-to-word/markdown-table-to-word-table): Three ways to get a real Word table from a Markdown pipe table: a converter, Pandoc, or Word's Convert Text to Table. Steps, column widths, limits. - [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. - [How do I convert CSV to Markdown from the command line?](https://docs-md.com/csv-to-markdown/csv-to-markdown-command-line): One-line commands with pandoc, Miller, csvkit and pandas that turn a CSV file into a markdown table, tested, with the quirks each tool has. - [How do I convert an Excel sheet to a Markdown table?](https://docs-md.com/csv-to-markdown/excel-to-markdown-table): Copy the cells in Excel, paste them into a CSV to Markdown converter, copy the table. Or save one sheet as CSV first. Steps, limits, and what gets lost. - [How do I convert a Google Sheet to a Markdown table?](https://docs-md.com/csv-to-markdown/google-sheets-to-markdown): Copy the cells into a CSV-to-markdown converter, or download the sheet as CSV. Exact steps, plus what breaks: merged cells, line breaks, pipes. - [JSON to markdown table converter](https://docs-md.com/json-to-markdown-table): Paste a JSON array or object and get a markdown table — nested keys flattened to dot paths, pipes escaped, columns reorderable — or turn a table back into JSON. - [Markdown to Slack converter](https://docs-md.com/markdown-to-slack): Turn standard markdown into Slack mrkdwn — *bold*, _italic_, links, headings as bold lines, tables as code grids — with a list of what was approximated. - [Markdown to Discord converter](https://docs-md.com/markdown-to-discord): Turn standard markdown into Discord markdown — headings to ###, masked links, code blocks with languages, tables as code grids — with every approximation listed. - [Markdown to Jira converter](https://docs-md.com/markdown-to-jira): Turn standard markdown into Jira wiki markup — h1. headings, *bold*, {code:lang} blocks, ||header|| tables, [text|url] links, ** nested lists — ready for issue fields. - [Markdown to plain text converter](https://docs-md.com/markdown-to-plain-text): Strip every markdown marker and keep the words, lists, code and paragraph structure — links optionally kept as "text (url)". For email, SMS, and form fields. ### 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. - [Can a Markdown table cell contain a list or an image?](https://docs-md.com/markdown-table-generator/markdown-table-cell-lists-images): An image, yes: it is inline content. A real list, no: pipe-table cells cannot hold block elements. The workarounds, and when to change the layout instead. - [Should I give an LLM a Markdown table or CSV?](https://docs-md.com/markdown-table-generator/markdown-table-vs-csv-for-llm): CSV uses fewer tokens; a Markdown table marks every cell boundary and renders in chat. Measured token counts, quoting pitfalls, and when to use neither. - [How do I sort a Markdown table?](https://docs-md.com/markdown-table-generator/sort-markdown-table): Markdown has no sort syntax; rows show in the order you write them. Sort with a spreadsheet round trip or the sort command, keeping the header in place. - [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. - [How do I open a README.md file?](https://docs-md.com/readme-generator/how-to-open-readme-md): A README.md is plain text, so any text editor opens it. How to see it formatted instead, on Windows, macOS, Linux, in VS Code, the terminal or a browser. - [What is a README file?](https://docs-md.com/readme-generator/what-is-a-readme-file): A README is the plain-text file that introduces a project: what it does, how to install and use it, and where to go next. Where it lives, what goes in it. - [What should a README contain?](https://docs-md.com/readme-generator/what-should-a-readme-contain): The sections a README needs, what good looks like in each, what to leave out, and how the list changes for a library, a CLI, an app or a dataset. - [Agent handoff document generator (HANDOFF.md)](https://docs-md.com/handoff-generator): Fill in goal, state, commands, key files, decisions and next steps; get a complete HANDOFF.md for the next developer or AI coding agent, with 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. - [How do I add a table of contents to a GitHub README?](https://docs-md.com/markdown-toc-generator/github-readme-table-of-contents): Write a nested list of links to your headings' anchors under the title, or rely on GitHub's built-in Outline menu. Exact syntax, slug rules and upkeep. - [How do I make a table of contents in Obsidian?](https://docs-md.com/markdown-toc-generator/obsidian-table-of-contents): Use the Outline core plugin for navigation, write a list of [[#Heading]] links for a TOC inside the note, or add a plugin that keeps one updated. - [How do I generate a Markdown table of contents in VS Code?](https://docs-md.com/markdown-toc-generator/vs-code-markdown-toc): VS Code has no built-in TOC command. Use the Markdown All in One extension, header link completions, or paste the file into a TOC generator. - [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. - [How do I format a README.md?](https://docs-md.com/github-readme-viewer/how-to-format-readme-md): The markdown a README.md needs on GitHub: headings, code blocks, lists, tables, relative links and images, alerts, line breaks, and which HTML survives. - [How do I preview a README before pushing to GitHub?](https://docs-md.com/github-readme-viewer/preview-readme-before-push): Four ways to see a README.md as GitHub will render it before it reaches main: editor preview, GitHub's Preview tab, a branch, or the markdown API. - [Why are my README images not showing on GitHub?](https://docs-md.com/github-readme-viewer/readme-images-not-showing): The causes of broken README images on GitHub, in order of likelihood: not pushed, wrong case, wrong relative path, spaces, private hosts, Camo. - [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. - [What is the difference between a markdown reader and a markdown editor?](https://docs-md.com/markdown-viewer/md-file-reader-vs-editor): A markdown reader shows a .md file formatted; an editor lets you write and change it, usually with a preview. Which you need, and examples of each. - [How do I open a .md file on iPhone or Android?](https://docs-md.com/markdown-viewer/open-md-file-iphone-android): Phones show a .md file as plain text or not at all. How to read it formatted on iPhone, iPad and Android: a browser viewer or a markdown app, step by step. - [How do I open a .md file on a Mac?](https://docs-md.com/markdown-viewer/open-md-file-mac): TextEdit and Quick Look show a .md file as raw text. How to read it formatted on macOS: a browser viewer, a Quick Look extension or VS Code's preview. - [How do I open a .md file on Windows?](https://docs-md.com/markdown-viewer/open-md-file-windows): A .md file is plain text, so Notepad opens it. How to see it formatted on Windows 10 and 11: newer Notepad, VS Code's preview or a browser viewer. - [How do I preview markdown in VS Code?](https://docs-md.com/markdown-viewer/preview-markdown-in-vs-code): Press Ctrl+Shift+V (Cmd+Shift+V on Mac) for the preview, or Ctrl+K V side by side. Preview locking, scroll sync, blocked images and styling. - [How do I share a rendered markdown file with someone who has no markdown app?](https://docs-md.com/markdown-viewer/render-markdown-to-pdf-or-link): Send a PDF when the document is final, or a link when it may change. How to make each from a .md file in a browser, and what each one keeps or loses. - [How do I view a markdown file in Chrome?](https://docs-md.com/markdown-viewer/view-markdown-in-chrome): Chrome shows .md files as plain text. Render them with an online viewer or a Markdown extension, and why extensions need file URL access for local files. - [Why does my .md file show # and * symbols instead of formatting?](https://docs-md.com/markdown-viewer/why-md-file-shows-symbols): A .md file is the source; the # and * are formatting instructions that only a markdown renderer turns into headings and bold. How to fix it. - [Markdown formatter (md formatter)](https://docs-md.com/markdown-formatter): Prettify messy markdown: uniform list markers, one emphasis style, aligned tables. Semantic — rendered output never changes. - [How do I align a markdown table so the columns line up?](https://docs-md.com/markdown-formatter/fix-markdown-table-alignment): Pad every cell to its column's widest entry so the pipes line up. Do it by hand, with an md formatter, or with Prettier. Colons only set text alignment. - [How do I format markdown in VS Code?](https://docs-md.com/markdown-formatter/format-markdown-in-vs-code): VS Code has no built-in markdown formatter. Install Prettier or markdownlint, set it as the default formatter, then run Format Document. - [How do I format markdown files with Prettier?](https://docs-md.com/markdown-formatter/format-markdown-with-prettier): Run npx prettier --write "**/*.md" to format every markdown file. What Prettier changes, the proseWrap option, ignore comments and CI checks. - [What is the difference between a markdown formatter and a linter?](https://docs-md.com/markdown-formatter/markdown-formatter-vs-linter): A formatter rewrites markdown into one style without asking. A linter reports rule violations and fixes only some. Most projects use both. ### 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. - [Markdown flavors compared](https://docs-md.com/markdown-flavors): 22 elements x 11 flavors matrix, portability rules, which-flavor-am-I-in. - [GitHub Flavored Markdown cheat sheet](https://docs-md.com/github-flavored-markdown): GFM vs CommonMark matrix, alerts, math, mermaid, fence language tags. - [Obsidian markdown cheat sheet](https://docs-md.com/obsidian-markdown): Wikilinks, embeds, 13 callout types, properties, tags, vs GFM. - [Notion markdown](https://docs-md.com/notion-markdown): Typing shortcuts, what imports, what Markdown & CSV export produces. - [Reddit markdown cheat sheet](https://docs-md.com/reddit-markdown): Spoilers, superscript, tables, Rich Text vs Markdown editor, old vs new Reddit. - [Telegram markdown (MarkdownV2) cheat sheet](https://docs-md.com/telegram-markdown): App shortcuts, Bot API MarkdownV2 with the full escape table, HTML parse mode, legacy Markdown. - [WhatsApp text formatting](https://docs-md.com/whatsapp-formatting): *bold*, _italic_, ~strike~, ```mono```, lists, quotes; what WhatsApp cannot render; Business API limits. - [Jira wiki markup vs Markdown](https://docs-md.com/jira-markdown): Markdown-to-wiki-markup translation table, Jira Cloud editor shortcuts, Confluence and REST v2/v3 differences. - [Markdown in ChatGPT and Claude answers](https://docs-md.com/markdown-for-ai-output): What each symbol means, prompts to request or suppress markdown, paste-destination fixes. - [MDX cheat sheet](https://docs-md.com/mdx-cheat-sheet): JSX, import/export, expressions, layouts, escaping, MDX 2 vs 3, Next.js/Docusaurus/Astro setup. - [Pandoc markdown cheat sheet](https://docs-md.com/pandoc-markdown): Extensions table, conversion commands, R Markdown and Quarto chunk syntax. - [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 alerts and callouts in markdown](https://docs-md.com/guides/markdown-alerts): GitHub alerts use > [!NOTE], [!TIP], [!IMPORTANT], [!WARNING], [!CAUTION] on a blockquote. Rendered meaning of each, the GitLab, Obsidian and Docusaurus equivalents, and where they show as plain quotes. - [How to link to a heading in markdown](https://docs-md.com/guides/markdown-anchor-link): Link to a heading in markdown with [text](#heading-slug). GitHub's slug rules (lowercase, spaces to hyphens, punctuation removed, duplicates get -1), fallback, cross-file anchors, and where anchors differ. - [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, punctuation rules, HTML fallbacks, and the Slack, Discord, WhatsApp, Jira and Pandoc 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
or

on GitHub (style= is stripped), center images and headings, table columns with :---:, and see which apps ignore it. - [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, Notion, Jira, Pandoc and MDX, nesting, progress tracking, accessibility and gotchas. - [How to write a code block in markdown](https://docs-md.com/guides/markdown-code-block): Make a code block with three backticks and a language tag for syntax highlighting. Inline code, backticks inside code, code in lists, diff and mermaid fences, and where fences render (GitHub, Slack, Discord, Notion, Obsidian). - [Markdown collapsible section: how to hide and expand text](https://docs-md.com/guides/markdown-collapsible-section): Markdown collapsible section: wrap content in

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 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 stay hidden in rendered output on GitHub, GitLab and Obsidian. Where they leak (Slack, Discord, Reddit, MDX), Obsidian %% and MDX {/* */} forms, and tool directives. - [How to make a definition list in markdown](https://docs-md.com/guides/markdown-definition-list): Definition list syntax (term on one line, : definition on the next) in Markdown Extra, Pandoc, kramdown and GitLab. GitHub has none: use a bold term with an indented paragraph or an HTML
. When a table is better. - [How to embed a video in markdown](https://docs-md.com/guides/markdown-embed-video): Embed a video in markdown: a clickable thumbnail link works everywhere, uploaded MP4/MOV URLs play inline on GitHub, iframes are stripped by GitHub and GitLab, and Obsidian, Notion, Docusaurus and Hugo each have their own YouTube embed. - [How to add emoji in markdown](https://docs-md.com/guides/markdown-emoji): Add emoji in markdown by typing :shortcode: (GitHub, GitLab, Slack, Discord, Obsidian plugins) or pasting the Unicode character, which works everywhere. Support matrix, top-50 shortcode table, accessibility. - [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, custom IDs, the one-H1 rule, setext underlines, accessibility, and where headings break in GitHub, Discord, Slack, Jira and Obsidian. - [How to highlight text in markdown](https://docs-md.com/guides/markdown-highlight): Highlight text in markdown with ==text== in Obsidian, Typora, Pandoc and Markdown Extra tools, or with text on GitHub and GitLab. No highlight in Slack, Discord or Reddit; alternatives that work. - [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): Add an image in markdown with ![alt text](url). Local paths, resizing with or {width=}, clickable images, captions, dark-mode logos, alt text rules, and where the syntax works. - [How to indent in markdown](https://docs-md.com/guides/markdown-indent): Indentation in markdown is syntax: 2 spaces nests a bullet, 3 nests under 1., 4 spaces makes a code block. Paragraph indents with  , continuation lines, tabs vs spaces, and per-app rules. - [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 nest lists in markdown](https://docs-md.com/guides/markdown-nested-list): Nest a markdown list by indenting the child item to where the parent's text starts: 2 spaces under -, 3 under 1., 4 under 10. CommonMark rule, mixed lists, paragraphs and code in items. - [How to make a new line in markdown](https://docs-md.com/guides/markdown-new-line): A single Enter collapses in markdown. Force a line break with two trailing spaces, a backslash or
; leave a blank line for a paragraph. Per-app rules for GitHub, Obsidian, Slack, Discord, Notion, and inside tables and lists. - [How to make a numbered list in markdown](https://docs-md.com/guides/markdown-numbered-list): Make a numbered list in markdown with 1. 2. 3. or just 1. 1. 1. — renderers auto-number. Start at any number, continue after a paragraph, the 1) form, nested numbering, and the renderers that differ. - [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
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 with double tildes, ~~like this~~. Single vs double tilde, Slack and Notion's single-tilde forms, vs fallbacks, accessibility, and a per-app table (GitHub, Discord, Obsidian, Jira, Pandoc). - [Markdown subscript: how to write text below the line](https://docs-md.com/guides/markdown-subscript): Markdown subscript syntax: text 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, text on GitHub and GitLab, Unicode ² characters in chat apps. Support table and fixes. - [How to make a table in markdown](https://docs-md.com/guides/markdown-table): Markdown table syntax: pipes for columns, a hyphen row under the header, colons for alignment. Escaping |, line breaks with
, empty cells, no colspan, and where tables render. - [How to add a line break in a markdown table cell](https://docs-md.com/guides/markdown-table-line-break): Put multiple lines in a markdown table cell with
. Two-space and backslash breaks do not work in tables. Escaped pipes in inline code, bullets inside cells, and when to switch to an HTML table. - [How to underline text in markdown](https://docs-md.com/guides/markdown-underline): Markdown has no underline syntax; underscores make italics. Use on GitHub (it strips ), __text__ on Discord, Ctrl+U in Notion and Jira, and see where no underline exists at all. ## Other languages - [Шпаргалка по Markdown: весь синтаксис с примерами](https://docs-md.com/ru/shpargalka-markdown): Русский, markdown cheat sheet - [Просмотр MD файлов онлайн](https://docs-md.com/ru/prosmotr-md-fajlov): Русский, markdown viewer - [Cú pháp Markdown – bảng tra cứu nhanh](https://docs-md.com/vi/cu-phap-markdown): Tiếng Việt, markdown cheat sheet - [Đọc file MD online](https://docs-md.com/vi/doc-file-md-online): Tiếng Việt, markdown viewer - [Sintaxis de Markdown: guía rápida con ejemplos](https://docs-md.com/es/sintaxis-markdown): Español, markdown cheat sheet - [Visor de Markdown: abrir y leer archivos .md en línea](https://docs-md.com/es/visor-md): Español, markdown viewer - [Sintaxe Markdown: colinha completa](https://docs-md.com/pt-br/sintaxe-markdown): Português (Brasil), markdown cheat sheet - [Visualizador Markdown: abrir arquivo md online](https://docs-md.com/pt-br/visualizador-markdown): Português (Brasil), markdown viewer ## Discovery - [Sitemap](https://docs-md.com/sitemap.xml): every indexable URL - [Full text](https://docs-md.com/llms-full.txt): every syntax guide and tool with its description and the opening answer paragraph, in one plain-text file - Raw markdown of any share: https://docs-md.com/raw/ or https://docs-md.com/.md (text/markdown), where is the share's URL path - [OpenAPI](https://docs-md.com/openapi.json): the share API as OpenAPI 3.1 - [Agent skill](https://docs-md.com/skill.md): SKILL.md for Claude Code and other agents - MCP server: https://docs-md.com/api/mcp (streamable HTTP, no auth; registry name com.docs-md/markdown-share) - [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 ## Notes - /api/ endpoints and user share pages (docs-md.com/) are not listed here or in the sitemap; shares are user content. - Dates (in llms-full.txt and on each page) are that page's own updated date, not the build date.