Markdown callout converter
Convert callout and admonition blocks between GitHub, Obsidian, Docusaurus and MkDocs syntax.
Markdown callout converter
Callout blocks—the boxed "Note", "Tip" or "Warning" asides in READMEs and documentation sites—are written differently by every platform. GitHub uses blockquote alerts like `> [!NOTE]`, Obsidian extends that syntax with custom titles and foldable arrows, Docusaurus wraps content in `:::tip` fences, and MkDocs (and Material for MkDocs) uses indented `!!! note` blocks with `???` for collapsible ones. Moving documentation between tools usually means rewriting every callout by hand—this tool converts them automatically.
Pick a source and target notation from the option panel, then paste content written in the source format. Every recognized callout is parsed and rewritten in the target syntax; anything else in the input—paragraphs, headings, other Markdown—passes through unchanged. "Keep custom block title" preserves a heading like Obsidian's `> [!info] Heads up` when the target supports one (GitHub has no title syntax, so a kept title becomes a bold first line instead). "Keep foldable/collapsible state" preserves Obsidian's `+`/`-` fold markers and MkDocs's `???`/`???+` syntax where the target has an equivalent; GitHub and Docusaurus have no collapsible callouts, so the toggle has no effect there. "Normalize block type" maps less common names (important, caution, success, question…) onto the five types every format shares: note, tip, warning, danger and info.
The body of each callout is preserved exactly as written, including nested lists, inline formatting, links and fenced code blocks—those are just ordinary lines inside the block. Multiple callouts in one document convert in a single pass, and Windows and Unix line endings are handled the same way.
Everything runs locally in your browser; your documentation is never uploaded anywhere. Copy the result, download it as a .txt file, or send the output back into the input to chain another conversion.