𝓜𝓪𝓻𝓴𝓸
A markdown parser with high extensibility.
Marko is a markdown parser written in pure Python that complies with CommonMark's spec v0.30. It is designed to be highly extensible, see Extensions for details.
Marko requires Python 3.6 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 with CommonMark's spec. It is a good reason for me to develop a new markdown parser.
Respecting that Marko complies with CommonMark's spec at the same time, which is a super complicated spec, Marko's performance will be affected. However, using a parser which doesn't comply with the CommonMark spec may give you unexpected rendered results from time to time. 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'd better choose another parser.
Use Marko
The installation is very simple:
$ pip install marko
And to use it:
import marko
print(marko.convert(text))
Marko also provides a simple CLI, for example, to render a document and output to a html file:
$ cat my_article.md | marko > my_article.html
Extensions
It is super easy to use an extension:
from marko import Markdown
from marko.ext.footnote import Footnote
# Add footnote extension
markdown = Markdown(extensions=[Footnote])
# Or you can just:
markdown = Markdown(extensions=['footnote'])
# Alternatively you can register an extension later
markdown.use(Footnote)
An example of using an extension with the command-line version of Marko:
$ cat this_has_footnote.txt | marko -e footnote > hi_world.html
Marko is shipped with 4 extensions: 'footnote', 'toc' 'pangu', 'codehilite'.
They are not included in CommonMark's spec but are common in other markdown parsers.
Marko also provides a Github flavored markdown parser which can be found at marko.ext.gfm.gfm.
Please refer to Extend Marko about how to write your own extension.
License
Marko is released under MIT License
Change Log
1 maintainer
Release files for marko 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| marko-1.3.0.tar.gz | 141.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| marko-1.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 180.9 kB
Release files / marko-1.3.0.tar.gz
| Download URL | marko-1.3.0.tar.gz |
|---|---|
| Size | 141.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8e52155860ebfb0394f92bc1ca7e5a30e4fca5392d71bf2af2b11971e8972667
|
|
BLAKE2b-256 checksum How to use checksums |
7db957dccb43ff55652e756a8374ab833146abd11911ab976b6ae6095ed88a68
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.8.16
|
Release files / marko-1.3.0-py3-none-any.whl
| Download URL | marko-1.3.0-py3-none-any.whl |
|---|---|
| Size | 39.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f5b03e68fa2fb76810d5e51a198d343e3b35e028d45e43c543c7c45e82170b66
|
|
BLAKE2b-256 checksum How to use checksums |
7289f00eb9e156580a7e359fde7bb3b0ead14be3b5490bceae4acc2556893dc4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.8.16
|
