# markdown-rs

CommonMark-compliant Markdown parser for Rust that builds a syntax tree and compiles Markdown to HTML, with GFM, MDX and math extensions.


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

## Record

### Links

- repository: https://github.com/wooorm/markdown-rs
- docs: https://docs.rs/markdown/latest/markdown/
- forum: https://github.com/wooorm/markdown-rs/discussions

### Identity

- status: active
- maintainer: Titus Wormer
- maintainerType: individual
- parent: unknown
- firstRelease: 2022
- hqCountry: unknown

### Kind

- category: library
- hosting: binary
- language: rust
- runtime: binary
- runtimeMin: unknown
- 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: cargo add

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 1
- latestReleaseDate: 2025-04-23

### Adoption

- githubStargazers: 1595
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 16
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 697
- dependentPackages: 86

### Sources

- urls: https://github.com/wooorm/markdown-rs (read 2026-11-16)
- urls: https://github.com/wooorm/markdown-rs/blob/main/readme.md (read 2026-11-16)
- maintainer: https://github.com/wooorm/markdown-rs/blob/main/license (read 2026-11-16)
- maintainerType: https://github.com/wooorm/markdown-rs/blob/main/license (read 2026-11-16)
- category: https://github.com/wooorm/markdown-rs/blob/main/readme.md (read 2026-11-16)
- language: https://github.com/wooorm/markdown-rs (read 2026-11-16)
- runtime: https://github.com/wooorm/markdown-rs/blob/main/readme.md (read 2026-11-16)
- installMethod: https://github.com/wooorm/markdown-rs/blob/main/readme.md (read 2026-11-16)
- license: https://github.com/wooorm/markdown-rs/blob/main/license (read 2026-11-16)
- licenseModel: https://github.com/wooorm/markdown-rs (read 2026-11-16)
- currentMajor: https://github.com/wooorm/markdown-rs/releases/tag/1.0.0 (read 2026-11-16)
- latestReleaseDate: https://github.com/wooorm/markdown-rs/releases/tag/1.0.0 (read 2026-11-16)
- firstRelease: https://github.com/wooorm/markdown-rs/releases/tag/1.0.0-alpha.1 (read 2026-11-16)
- githubStargazers: https://github.com/wooorm/markdown-rs (read 2026-11-16)
- contributors: https://api.github.com/repos/wooorm/markdown-rs/contributors?per_page=1 (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/crates.io/packages/markdown (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/crates.io/packages/markdown (read 2026-11-16)

## Notes

markdown-rs parses Markdown into events and then compiles them to HTML or to a syntax tree in the mdast format, with a position for each node. A Rust program calls `to_html` for a string of Markdown, or `to_html_with_options` with an `Options` value to switch on GFM, MDX, frontmatter and math. Its parser is a state machine built on alloc without the standard library, and it accounts for every byte of the input.

The README names micromark, a JavaScript Markdown parser, as a sibling project, and mdxjs-rs wraps this crate to compile MDX to JavaScript.

## Worth knowing

HTML output is safe by default: dangerous HTML and protocols are encoded or dropped unless `allow_dangerous_html` or `allow_dangerous_protocol` is turned on. MDX syntax errors come back as an error value from `to_html_with_options`, and the README advises capping the size of untrusted input before parsing it.

---

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
