---
id: comrak
version: "0.0.16"
license: unclear
license_treatment: permissive
maintenance: active
---

# comrak — Python bindings for the Comrak Rust library, a fast CommonMark/GFM parser

License: permissive · Maintenance: active · Downloads: 284.1K/mo

## What it is and what it does

Comrak is a Python wrapper around the Comrak Rust library, exposing a fast CommonMark and GitHub Flavored Markdown parser. It offers two main rendering modes: `render_markdown()` for HTML output and `render_commonmark()` for normalized CommonMark text. The package exposes the full option surface of the underlying Rust library—Extension, Parse, and Render options—allowing fine-grained control over parsing behavior and output formatting, including support for alerts, shortcodes, and list style customization.

The binding has no runtime dependencies and ships with prebuilt wheels for modern Python versions (3.9–3.14) and multiple platforms, making installation straightforward. It is actively maintained and tracks Comrak 0.54. The package is suitable for applications that need fast, standards-compliant markdown processing with access to advanced parsing and rendering options.

Use it for:

- Convert user-supplied markdown to safe HTML in web applications or content management systems.
- Normalize and reformat markdown documents using CommonMark output and list-style options.
- Parse markdown with GitHub Flavored Markdown extensions (tables, strikethrough, autolinks) for documentation tools.
- Render markdown alerts and semantic HTML features in static site generators or documentation platforms.
- Process markdown with shortcode expansion (emoji, custom tags) in content pipelines.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Renders CommonMark and GitHub Flavored Markdown to HTML or normalized CommonMark via Python bindings to the Rust Comrak parser.

Yes. The package is actively maintained, has no known vulnerabilities, zero runtime dependencies, and offers prebuilt wheels across major platforms and Python versions. It provides a fast, standards-compliant markdown parser with a rich options API. Install it if you need CommonMark/GFM parsing with performance or advanced rendering control; skip it if you need only basic markdown-to-HTML conversion and are comfortable with slower pure-Python alternatives.

## Install

pip install comrak
uv add comrak
poetry add comrak

## Installing comrak

Before you install: Medium install friction due to compiled wheels, but prebuilt binaries are available for Python 3.9–3.14 across Linux, macOS, and Windows architectures. Last release 18 days ago; repository is active with recent commits.

License in practice: Licensed under permissive terms (2-Clause BSD per the description); no restrictions on commercial or proprietary use.

Quickstart:

pip install comrak
import comrak
html = comrak.render_markdown("# Hello")
commonmark = comrak.render_commonmark("- one\n- two")

Requires Python 3.9 or later.

Verify before relying:

- Whether the package's performance claims (15x–60x faster than markdown/markdown2) remain current and reproducible.
- Whether all comrak 0.54 features are fully exposed or if new Rust library releases introduce gaps.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 284.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

markdown to html parser, commonmark gfm renderer, fast markdown parsing, rust markdown bindings, markdown processor python, markdown-parser, rust-bindings

[View on SkillFed](https://skillfed.io/packages/comrak) · [View on PyPI](https://pypi.org/project/comrak/)