# markdown-it-py

Python port of the markdown-it Markdown parser, which follows the CommonMark spec and supports syntax plugins.


Source: https://findsoftware.frbit.cloud/markdown-it-py/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://markdown-it-py.readthedocs.io
- repository: https://github.com/executablebooks/markdown-it-py
- docs: https://markdown-it-py.readthedocs.io
- plugins: https://markdown-it-py.readthedocs.io/en/latest/plugins.html

### Identity

- status: active
- maintainer: ExecutableBookProject
- maintainerType: community
- parent: unknown
- firstRelease: 2020
- hqCountry: unknown

### Kind

- category: library
- hosting: python
- language: python
- runtime: python
- runtimeMin: python 3.10
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: not applicable
- renderingModes: not applicable
- installMethod: pip, conda

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 4
- latestReleaseDate: 2026-11-10

### Adoption

- githubStargazers: 1397
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 55
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 11935
- dependentPackages: 508

### Sources

- urls: https://markdown-it-py.readthedocs.io/en/latest/ (read 2026-11-16)
- urls: https://github.com/executablebooks/markdown-it-py (read 2026-11-16)
- urls: https://github.com/executablebooks/markdown-it-py/blob/master/README.md (read 2026-11-16)
- maintainer: https://github.com/executablebooks/markdown-it-py/blob/v4.3.0/LICENSE (read 2026-11-16)
- maintainerType: https://github.com/executablebooks/markdown-it-py/blob/v4.3.0/LICENSE (read 2026-11-16)
- urls: https://markdown-it-py.readthedocs.io/en/latest/ (read 2026-11-16)
- category: https://github.com/executablebooks/markdown-it-py/blob/master/README.md (read 2026-11-16)
- language: https://github.com/executablebooks/markdown-it-py (read 2026-11-16)
- runtime: https://github.com/executablebooks/markdown-it-py/blob/master/README.md (read 2026-11-16)
- runtimeMin: https://github.com/executablebooks/markdown-it-py/blob/v4.3.0/pyproject.toml (read 2026-11-16)
- installMethod: https://github.com/executablebooks/markdown-it-py/blob/master/README.md (read 2026-11-16)
- installMethod: https://github.com/executablebooks/markdown-it-py/blob/master/README.md (read 2026-11-16)
- license: https://github.com/executablebooks/markdown-it-py/blob/v4.3.0/LICENSE (read 2026-11-16)
- licenseModel: https://github.com/executablebooks/markdown-it-py (read 2026-11-16)
- currentMajor: https://github.com/executablebooks/markdown-it-py/releases/tag/v4.3.0 (read 2026-11-16)
- latestReleaseDate: https://github.com/executablebooks/markdown-it-py/releases/tag/v4.3.0 (read 2026-11-16)
- firstRelease: https://github.com/executablebooks/markdown-it-py/releases/tag/v0.1.1d (read 2026-11-16)
- githubStargazers: https://github.com/executablebooks/markdown-it-py (read 2026-11-16)
- contributors: https://api.github.com/repos/executablebooks/markdown-it-py/contributors?per_page=1 (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/markdown-it-py (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/markdown-it-py (read 2026-11-16)

## Notes

markdown-it-py parses Markdown into a stream of tokens and renders the tokens to HTML. It follows the CommonMark spec for the base syntax, and its rules can be extended or replaced in code. Syntax beyond CommonMark comes from plugins that are added to a parser object with `use`, and a plugin such as the table syntax is switched on with `enable`.

It is a Python port of markdown-it, the JavaScript parser, and changes as little of the JavaScript code structure as possible. The package also installs a command-line tool, `markdown-it`, which reads files or standard input and writes HTML to standard output.

## Worth knowing

Tables are off by default, as in CommonMark, so a document that uses table syntax needs the table option or the command-line flag to render it as a table.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
