---
id: tree-sitter-markdown
version: "0.5.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# tree-sitter-markdown — Markdown grammar for tree-sitter

License: permissive · Maintenance: active · Downloads: 2.1M/mo

## 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 above — verify before relying.

Provides a tree-sitter grammar for parsing Markdown documents, enabling syntactic analysis of Markdown text according to CommonMark with optional extensions like GitHub flavored markdown, task lists, and tables.

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

pip install tree-sitter-markdown
uv add tree-sitter-markdown
poetry add tree-sitter-markdown

## Installing tree-sitter-markdown

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.

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 tree

Requires Python 3.9 or later; tree-sitter Python bindings must be installed separately to use the grammar for actual parsing

Verify 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_current
- Install friction: medium
- Maintenance: active
- Downloads: 2.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

markdown parser tree-sitter, parse markdown syntax tree, markdown grammar analysis, commonmark parser python, markdown ast extraction, syntax highlighting markdown, markdown document parsing, parsing, syntax-highlighting, tree-sitter

[View on SkillFed](https://skillfed.io/packages/tree-sitter-markdown) · [View on PyPI](https://pypi.org/project/tree-sitter-markdown/)