tree-sitter-markdown
Markdown grammar for tree-sitter
Decision gist · record as of 2026-08-14
Yes, if you need tree-sitter-based Markdown parsing for syntax highlighting or structural analysis. The permissive MIT license, active maintenance, and precompiled wheels make it straightforward to install. However, do not use it where Markdown correctness is critical—the authors acknowledge known inaccuracies. For general-purpose Markdown parsing where fidelity matters, consider alternatives.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later; tree-sitter Python bindings must be installed separately to use the grammar for actual parsing
- Medium install friction due to compiled wheels; prebuilt binaries are available for common platforms (macOS, Linux, Windows on x86_64 and ARM64), reducing build requirements.
- Package is actively maintained with recent releases.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use, modify, and distribute this package with minimal restrictions, requiring only attribution and inclusion of the license notice.
last release 2025-09-16 (332 days) · last repo commit 2026-07-19 · 615 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,085,173 downloads/mo, #3,305 on PyPI
Alternatives
Verify before relying
pip install tree-sitter-markdown
import tree_sitter_markdown
# Use with tree-sitter bindings to parse Markdown text into a syntax tree- Whether the parser's known inaccuracies (noted in the description) are acceptable for your specific use case beyond syntax highlighting
- Performance characteristics and parsing speed for large or deeply nested Markdown documents
- Compatibility with tree-sitter bindings beyond the Python layer
What it is and what it does
tree-sitter-markdown is a Markdown parser grammar for the tree-sitter incremental parsing framework. It parses Markdown text into a syntax tree following the CommonMark specification, with optional support for extensions like GitHub flavored markdown, task lists, strikethrough, pipe tables, and YAML/TOML metadata blocks. The parser is designed primarily for syntax highlighting and syntactic analysis in editors like Neovim and Helix.
The package is distributed as precompiled wheels for Python 3.9 and later, with no runtime dependencies. However, the authors explicitly note that the parser has known inaccuracies due to the constraints of fitting Markdown into tree-sitter's parsing rules, and recommend against using it where correctness is critical. Standalone usage requires two-pass parsing: first with the block grammar, then with the inline grammar using included ranges to mark inline content.
Use it for
- Syntax highlighting for Markdown in text editors and IDE plugins that use tree-sitter
- Extracting structural information from Markdown documents for linting or analysis tools
- Building Markdown-aware code editors or documentation viewers with incremental parsing
- Parsing Markdown with GitHub extensions (tables, task lists, strikethrough) for web or static site generators
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need tree-sitter-based Markdown parsing for syntax highlighting or structural analysis.
The permissive MIT license, active maintenance, and precompiled wheels make it straightforward to install. However, do not use it where Markdown correctness is critical—the authors acknowledge known inaccuracies. For general-purpose Markdown parsing where fidelity matters, consider alternatives.
Install
tree-sitter-markdown on PyPI
Before you install
Medium install friction due to compiled wheels; prebuilt binaries are available for common platforms (macOS, Linux, Windows on x86_64 and ARM64), reducing build requirements. Package is actively maintained with recent releases.
Requires Python 3.9 or later; tree-sitter Python bindings must be installed separately to use the grammar for actual parsing
License in practice
MIT license is permissive; you can use, modify, and distribute this package with minimal restrictions, requiring only attribution and inclusion of the license notice.
Quickstart
pip install tree-sitter-markdown
import tree_sitter_markdown
# Use with tree-sitter bindings to parse Markdown text into a syntax treeVerify before relying
- Whether the parser's known inaccuracies (noted in the description) are acceptable for your specific use case beyond syntax highlighting
- Performance characteristics and parsing speed for large or deeply nested Markdown documents
- Compatibility with tree-sitter bindings beyond the Python layer
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 332 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,085,173 / month, #3,305 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseTopic :: Software Development :: CompilersTopic :: Text Processing :: LinguisticTyping :: Typed |
Evidence: tree_sitter_markdown-0.5.1-cp39-abi3-macosx_10_9_x86_64.whl; tree_sitter_markdown-0.5.1-cp39-abi3-macosx_11_0_arm64.whl; tree_sitter_markdown-0.5.1-cp39-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; tree_sitter_markdown-0.5.1-cp39-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl; tree_sitter_markdown-0.5.1-cp39-abi3-musllinux_1_2_aarch64.whl; tree_sitter_markdown-0.5.1-cp39-abi3-musllinux_1_2_x86_64.whl; tree_sitter_markdown-0.5.1-cp39-abi3-win_amd64.whl; tree_sitter_markdown-0.5.1-cp39-abi3-win_arm64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “markdown parser tree-sitter”
- tree-sitter-markdownProvides a tree-sitter grammar for parsing Markdown documents,…
- graphifyyParses code, docs, PDFs, images, and video into a queryable knowledge…
- tree-sitter-xmlProvides a tree-sitter parser grammar for XML and DTD files, enabling…
Give your agent the search over MCP, or paste the wish link into any chat.
More Linguistic packages
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
tiktoken is a fast BPE tokenizer that converts text into token sequences compatible with OpenAI models, supporting multiple encoding schemes including o200k_base and model-specific encodings.
Install it if you work with OpenAI APIs or need to understand token boundaries in GPT-family models.
Detects character encoding and language in byte sequences with high accuracy, supporting 99 encodings and returning confidence scores, language tags, and MIME types.
Install it if you need to detect character encoding or language in byte data; the rewrite makes it substantially faster and more accurate than its predecessors.
Converts Unicode text to ASCII by transliterating non-ASCII characters into their closest ASCII equivalents, with no runtime dependencies.
However, if transliteration quality or ongoing maintenance matters, consider unidecode instead despite its GPL-only license.
Lark is a parsing library that builds abstract syntax trees from context-free grammars, supporting multiple parsing algorithms (Earley, LALR(1), CYK) with automatic line and column tracking.
Python bindings to the tree-sitter parsing library, enabling incremental parsing and syntax tree analysis for source code.
See also tree-sitter-toml · tree-sitter-xml · tree-sitter-python · html-to-markdown · tree-sitter-yaml · tree-sitter-zig · pymarkdownlnt · tree-sitter-java · mistletoe · dbt-extractor