# Markdown extensions 28 projects, most used and most active first. 1 of them builds on MkDocs NG in the weekly [compatibility test](https://github.com/mkdocs-ng/mkdocs/actions/workflows/compat.yml). Data from 2026-11-01. ## PyMdown Extensions Extensions for Python Markdown. - **Install:** `pip install pymdown-extensions` - **Markdown extensions:** `pymdownx.arithmatex`, `pymdownx.b64`, `pymdownx.betterem`, `pymdownx.blocks.admonition`, `pymdownx.blocks.definition`, `pymdownx.blocks.details`, `pymdownx.blocks.html`, `pymdownx.blocks.tab` and 21 more - :lucide-badge-check: **Builds on MkDocs NG** in the [weekly compatibility test](https://github.com/mkdocs-ng/mkdocs/actions/workflows/compat.yml) - :lucide-star: 1.1k · :lucide-download: 18.3M/month · :lucide-clock: last commit 2026-10-31 - [:brand-github: GitHub](https://github.com/facelessuser/pymdown-extensions) · [:brand-pypi: PyPI](https://pypi.org/project/pymdown-extensions/) ## Math extension Math extension for Python-Markdown. - **Install:** `pip install python-markdown-math` - **Markdown extension:** `mdx_math` - :lucide-star: 128 · :lucide-download: 355k/month · :lucide-clock: last commit 2025-04-10 · :lucide-scale: BSD-3-Clause - [:brand-github: GitHub](https://github.com/mitya57/python-markdown-math) · [:brand-pypi: PyPI](https://pypi.org/project/python-markdown-math/) > [!WARNING] > No commits since 2025-04-10. Check that it still fits your setup. ## mkdocs-callouts A simple MkDocs plugin that converts Obsidian callout blocks to mkdocs supported Admonitions. - **Install:** `pip install mkdocs-callouts` - **Plugin:** `callouts` - :lucide-star: 52 · :lucide-download: 54k/month · :lucide-clock: last commit 2026-08-27 · :lucide-scale: MIT - [:brand-github: GitHub](https://github.com/sondregronas/mkdocs-callouts) · [:brand-pypi: PyPI](https://pypi.org/project/mkdocs-callouts/) ## markdown-callouts Markdown extension: a classier syntax for admonitions. - **Install:** `pip install markdown-callouts` - **Markdown extensions:** `callouts`, `github-callouts` - :lucide-star: 45 · :lucide-download: 86k/month · :lucide-clock: last commit 2026-04-17 · :lucide-scale: MIT - [:brand-github: GitHub](https://github.com/oprypin/markdown-callouts) · [:brand-pypi: PyPI](https://pypi.org/project/markdown-callouts/) ## YAML metadata YAML metadata extension for Python-Markdown. - **Install:** `pip install markdown-full-yaml-metadata` - **Markdown extension:** `full_yaml_metadata` - :lucide-star: 29 · :lucide-download: 1.2k/month · :lucide-clock: last commit 2026-03-25 · :lucide-scale: MIT - [:brand-github: GitHub](https://github.com/sivakov512/python-markdown-full-yaml-metadata) · [:brand-pypi: PyPI](https://pypi.org/project/markdown-full-yaml-metadata/) ## Mdx Truly Sane Lists Extension for Python-Markdown that makes lists truly sane. Custom indents for nested lists and fix for messy.. - **Install:** `pip install mdx-truly-sane-lists` - **Markdown extension:** `mdx_truly_sane_lists` - :lucide-star: 101 · :lucide-download: 970k/month · :lucide-clock: last commit 2022-07-19 · :lucide-scale: MIT - [:brand-github: GitHub](https://github.com/radude/mdx_truly_sane_lists) · [:brand-pypi: PyPI](https://pypi.org/project/mdx-truly-sane-lists/) > [!WARNING] > No commits since 2022-07-19. Check that it still fits your setup. ## Markdown Inline Graphviz Render inline graphs with Markdown and Graphviz. - **Install:** `pip install markdown-inline-graphviz-extension` - **Markdown extension:** `markdown_inline_graphviz` - :lucide-star: 5 · :lucide-download: 50k/month · :lucide-clock: last commit 2024-01-16 · :lucide-scale: MIT - [:brand-github: GitHub](https://github.com/cesaremorel/markdown-inline-graphviz) · [:brand-pypi: PyPI](https://pypi.org/project/markdown-inline-graphviz-extension/) > [!WARNING] > No commits since 2024-01-16. Check that it still fits your setup. ## Markdown Checklist Python Markdown extension for lists of tasks with checkboxes. - **Install:** `pip install markdown-checklist` - **Markdown extension:** `markdown_checklist.extension` - :lucide-star: 82 · :lucide-download: 7.3k/month · :lucide-clock: last commit 2022-07-29 · :lucide-scale: MIT - [:brand-github: GitHub](https://github.com/FND/markdown-checklist) · [:brand-pypi: PyPI](https://pypi.org/project/markdown-checklist/) > [!WARNING] > No commits since 2022-07-29. Check that it still fits your setup. ## MarkdownSuperscript An extension to the Python Markdown package enabling superscript text. - **Install:** `pip install MarkdownSuperscript` - **Markdown extension:** `superscript` - :lucide-star: 2 · :lucide-download: 233/month · :lucide-clock: last commit 2018-12-02 · :lucide-scale: BSD-2-Clause - [:brand-github: GitHub](https://github.com/jambonrose/markdown_superscript_extension) · [:brand-pypi: PyPI](https://pypi.org/project/MarkdownSuperscript/) > [!WARNING] > No commits since 2018-12-02. Check that it still fits your setup. ## Breakless Lists Python markdown breakless lists extension. - **Install:** `pip install mdx-breakless-lists` - **Markdown extension:** `mdx_breakless_lists` - :lucide-star: 7 · :lucide-download: 40k/month · :lucide-clock: last commit 2020-10-08 · :lucide-scale: MIT - [:brand-github: GitHub](https://github.com/adamb70/mdx-breakless-lists) · [:brand-pypi: PyPI](https://pypi.org/project/mdx-breakless-lists/) > [!WARNING] > No commits since 2020-10-08. Check that it still fits your setup. ## MarkdownSubscript An extension to the Python Markdown package enabling subscript text. - **Install:** `pip install MarkdownSubscript` - **Markdown extension:** `subscript` - :lucide-star: 3 · :lucide-download: 71/month · :lucide-clock: last commit 2018-12-02 · :lucide-scale: BSD-2-Clause - [:brand-github: GitHub](https://github.com/jambonrose/markdown_subscript_extension) · [:brand-pypi: PyPI](https://pypi.org/project/MarkdownSubscript/) > [!WARNING] > No commits since 2018-12-02. Check that it still fits your setup. ## caption - **Markdown extensions:** `caption`, `image_captions`, `table_captions` - :lucide-star: 12 · :lucide-clock: last commit 2025-05-03 · :lucide-scale: GPL-3.0 - [:brand-github: GitHub](https://github.com/flywire/caption) > [!WARNING] > No commits since 2025-05-03. Check that it still fits your setup. ## markdown-emdash Emdash extension for python-markdown. - **Install:** `pip install markdown-emdash` - **Markdown extension:** `mdx_emdash` - :lucide-star: 3 · :lucide-download: 197/month · :lucide-clock: last commit 2023-05-18 · :lucide-scale: MIT - [:brand-github: GitHub](https://github.com/czue/markdown-emdash) · [:brand-pypi: PyPI](https://pypi.org/project/markdown-emdash/) > [!WARNING] > No commits since 2023-05-18. Check that it still fits your setup. ## markdown-icons Easily display icon fonts in markdown. - **Install:** `pip install markdown-iconfonts` - **Markdown extension:** `iconfonts` - :lucide-star: 15 · :lucide-download: 57/month · :lucide-clock: last commit 2018-12-09 - [:brand-github: GitHub](https://github.com/MadLittleMods/markdown-icons) · [:brand-pypi: PyPI](https://pypi.org/project/markdown-iconfonts/) > [!WARNING] > No commits since 2018-12-09. Check that it still fits your setup. ## markdown-katex KaTeX extension for Python Markdown. - **Install:** `pip install markdown-katex` - **Markdown extension:** `markdown_katex` - :lucide-star: 11 · :lucide-download: 13k/month - [:brand-pypi: PyPI](https://pypi.org/project/markdown-katex/) · [Homepage](https://gitlab.com/mbarkhau/markdown-katex) ## python-asciimathml python ASCIIMathML to Presentation MathML translator. - **Install:** `pip install asciimathml` - **Markdown extension:** `mdx_asciimathml` - :lucide-star: 4 · :lucide-download: 118/month · :lucide-clock: last commit 2017-04-04 · :lucide-scale: GPL-3.0 - [:brand-github: GitHub](https://github.com/ShadowKyogre/python-asciimathml) · [:brand-pypi: PyPI](https://pypi.org/project/asciimathml/) > [!WARNING] > No commits since 2017-04-04. Check that it still fits your setup. ## Markdown PyCon Markdown extension to parse `pycon` code blocks without indentation or fences. - **Markdown extension:** `pycon` - :lucide-star: 2 · :lucide-clock: last commit 2026-10-23 · :lucide-scale: ISC - [:brand-github: GitHub](https://github.com/pawamoy/markdown-pycon) ## mkpatcher Python-Markdown extension allowing arbitrary scripts to modify MkDocs input files. - **Install:** `pip install mkpatcher` - **Markdown extension:** `mkpatcher` - :lucide-star: 2 · :lucide-download: 912/month · :lucide-clock: last commit 2020-04-26 · :lucide-scale: Apache-2.0 - [:brand-github: GitHub](https://github.com/ofek/mkpatcher) · [:brand-pypi: PyPI](https://pypi.org/project/mkpatcher/) > [!WARNING] > No commits since 2020-04-26. Check that it still fits your setup. ## Tweetable quotes Python-Markdown extension to embed tweetable quotes into your blog posts. - **Install:** `pip install markdown-tweetable` - **Markdown extension:** `tweetable.extension` - :lucide-star: 16 · :lucide-download: 26/month · :lucide-clock: last commit 2019-03-25 · :lucide-scale: MIT - [:brand-github: GitHub](https://github.com/max-arnold/markdown-tweetable) · [:brand-pypi: PyPI](https://pypi.org/project/markdown-tweetable/) > [!WARNING] > No commits since 2019-03-25. Check that it still fits your setup. ## HEARTBEATS Flavored Markdown HEARTBEATS Flavored Markdown extension. - **Install:** `pip install hbfm` - **Markdown extensions:** `hbfm.inline_coloring`, `hbfm.inline_list`, `hbfm.number_headers`, `hbfm.quote_uri_hash` - :lucide-star: 15 · :lucide-download: 286/month · :lucide-clock: last commit 2018-03-01 - [:brand-github: GitHub](https://github.com/heartbeatsjp/markdown-extension-hbfm) · [:brand-pypi: PyPI](https://pypi.org/project/hbfm/) > [!WARNING] > No commits since 2018-03-01. Check that it still fits your setup. ## markdown-del-ins Markdown extension to support the del and ins tags. - **Install:** `pip install markdown-del-ins` - **Markdown extension:** `markdown_del_ins` - :lucide-star: 13 · :lucide-download: 2.1k/month · :lucide-clock: last commit 2020-01-09 - [:brand-github: GitHub](https://github.com/honzajavorek/markdown-del-ins) · [:brand-pypi: PyPI](https://pypi.org/project/markdown-del-ins/) > [!WARNING] > No commits since 2020-01-09. Check that it still fits your setup. ## KBD Extension KBD Extension for Python-Markdown. - **Install:** `pip install kbdextension` - **Markdown extension:** `kbdextension` - :lucide-star: 2 · :lucide-download: 106/month · :lucide-clock: last commit 2020-06-08 · :lucide-scale: MIT - [:brand-github: GitHub](https://github.com/RickTalken/kbdextension) · [:brand-pypi: PyPI](https://pypi.org/project/kbdextension/) > [!WARNING] > No commits since 2020-06-08. Check that it still fits your setup. ## markdown_sub_sup A python markdown extension for add sub and sup support. - **Install:** `pip install markdown-sub-sup` - **Markdown extension:** `markdown_sub_sup` - :lucide-star: 2 · :lucide-download: 798/month · :lucide-clock: last commit 2023-03-24 · :lucide-scale: LGPL-3.0 - [:brand-github: GitHub](https://github.com/alberic89/markdown_sub_sup) · [:brand-pypi: PyPI](https://pypi.org/project/markdown-sub-sup/) > [!WARNING] > No commits since 2023-03-24. Check that it still fits your setup. ## Markdown Grid Tables [Python-Markdown](https://python-markdown.github.io/) [extension](https://python-markdown.github.io/extensions/api/).. - **Install:** `pip install markdown-grid-tables` - **Markdown extension:** `markdown_grid_tables` - :lucide-star: 1 · :lucide-download: 46k/month - [:brand-pypi: PyPI](https://pypi.org/project/markdown-grid-tables/) · [Homepage](https://gitlab.com/WillDaSilva/markdown_grid_tables) ## Cite Extension Python-Markdown extension to support the cite tag. - **Install:** `pip install mdx-cite` - **Markdown extension:** `mdx_cite` - :lucide-star: 7 · :lucide-download: 29/month · :lucide-clock: last commit 2012-04-21 - [:brand-github: GitHub](https://github.com/aleray/mdx_cite) · [:brand-pypi: PyPI](https://pypi.org/project/mdx-cite/) > [!WARNING] > No commits since 2012-04-21. Check that it still fits your setup. ## Semantic WikiLinks Extension Python-Markdown extension to add support for semantic (wiki)links (RDFa). - **Install:** `pip install mdx-semanticwikilinks` - **Markdown extension:** `mdx_semanticwikilinks` - :lucide-star: 9 · :lucide-download: 33/month · :lucide-clock: last commit 2012-08-15 - [:brand-github: GitHub](https://github.com/aleray/mdx_semanticwikilinks) · [:brand-pypi: PyPI](https://pypi.org/project/mdx-semanticwikilinks/) > [!WARNING] > No commits since 2012-08-15. Check that it still fits your setup. ## Semantic Data Extension Python-Markdown extension to add support for semantic data (RDFa). - **Install:** `pip install mdx-semanticdata` - **Markdown extension:** `mdx_semanticdata` - :lucide-star: 8 · :lucide-download: 27/month · :lucide-clock: last commit 2012-11-05 - [:brand-github: GitHub](https://github.com/aleray/mdx_semanticdata) · [:brand-pypi: PyPI](https://pypi.org/project/mdx-semanticdata/) > [!WARNING] > No commits since 2012-11-05. Check that it still fits your setup. ## Django Static Image - **Install:** `pip install markdown-djangostaticimage` - **Markdown extension:** `django_static_image` - :lucide-download: 33/month - [:brand-pypi: PyPI](https://pypi.org/project/markdown-djangostaticimage/) · [Homepage](https://pypi.org/project/markdown-djangostaticimage/)