Skip to content
Switch branches/tags


Build Coverage Downloads Size Sponsors Backers Chat

remark is a markdown processor built on micromark powered by plugins part of the unified collective.


remark is the world’s most popular markdown parser! And it does so much more than parse: it inspects (check, lint) and transforms (generate, compile) markdown too!

Everything is possible with plugins, such as checking markdown code style (remark-lint), transforming safely to React (remark-react), adding a table of contents (remark-toc), or compiling to man pages (remark-man).

Internally, remark now uses micromark, a new, fast, and tiny CommonMark compliant markdown tokenizer. It can be GFM compliant with remark-gfm.

Finally, remark is part of the unified collective. Learn more about us:


This repository contains the following packages:

  • remark-parse — Parse markdown to syntax trees
  • remark-stringify — Serialize syntax trees to markdown
  • remark — Programmatic interface with both remark-parse and remark-stringify
  • remark-cli — Command line interface wrapping remark


As markdown is sometimes used for HTML, and improper use of HTML can open you up to a cross-site scripting (XSS) attack, use of remark can also be unsafe. When going to HTML, use remark in combination with the rehype ecosystem, and use rehype-sanitize to make the tree safe.

Use of remark plugins could also open you up to other attacks. Carefully assess each plugin and the risks involved in using them.


See in remarkjs/.github for ways to get started. See for ways to get help. Ideas for new plugins and tools can be posted in remarkjs/ideas. Join us in Discussions to chat with the community and contributors.

A curated list of awesome resources can be found in awesome remark.

This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.


Support this effort and give back by sponsoring on OpenCollective!

Gatsby 🥇

Vercel 🥇




Boost Hub




MIT © Titus Wormer