Skip to main content

A markdown parser with high extensibility.

Project description


A markdown parser with high extensibility.

PyPI PyPI - Python Version Documentation Status CommonMark Spec

Build Status AppVeyor Status codecov

Marko is a markdown parser written in pure Python that complies CommonMark's spec v0.29. It is designed to be highly extensible, see Extend Marko for details.

Marko requires Python2.7, Python 3.5 or higher.

Why Marko

Among all implementations of Python's markdown parser, it is a common issue that user can't easily extend it to add his own features. Furthermore, Python-Markdown and mistune don't comply CommonMark's spec. It is a good reason for me to develop a new markdown parser and use it.

Respecting that Marko complies CommonMark's spec at the same time, which is a super complicated spec, Marko's performance will be affected. A benchmark result shows that Marko is 3 times slower than Python-Markdown, but a bit faster than Commonmark-py, much slower than mistune. If performance is a bigger concern to you than spec compliance, you's better choose another parser.

Use Marko

The installation is very simple:

$ pip install marko

And to use it:

import marko


Marko also provides a simple CLI, for example, to render a document and output to a html file:

$ cat | marko > my_article.html

Extend Marko

Please refer to Document


Marko is released under MIT License

Change Log

  • v0.5.0: Update to comply commonmark spec 0.29; Change the extension system.
  • v0.4.3: Fix TOC rendering when heading level exceeds the max depth.
  • v0.4.2: Fix CJK regexp for pangu extension.
  • v0.4.0: Support Python 2.7.
  • v0.3.4: Fix bugs about extensions.
  • v0.3.1: Pangu extension.
  • v0.3.0: Change the entry function to a class, add TOC and footnotes extensions.
  • v0.2.0: Github flavored markdown and docs.
  • v0.1.0: Commonmark spec tests.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

marko-0.5.0.tar.gz (26.4 kB view hashes)

Uploaded Source

Built Distribution

marko-0.5.0-py2.py3-none-any.whl (35.7 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page