I ported CommonMark to mkdocs

[qbane]

Mkdocs, a project documentation generator, uses Python-Markdown as its Markdown engine. As a fan of CommonMark, I have tried to integrate CommonMark since several weeks ago. Mkdocs is written in Python, and to my surprise, there is few implementation that fully conforms to a documented spec, let alone CommonMark. Nevertheless, I picked the following implementation and put effort to glue things together:

Mistletoe: a fast, extensible CommonMark implementation in pure Python

I’ve personally wanted a CommonMark-conformant parser implementation in pure Python for a while. python-markdown and mistune, for example, both supports Gruber’s specification, but not CommonMark. There is, more recently, CommonMark-py, which is a direct port of commonmark.js. mistletoe, the project I have been working on for almost a year now, is a Markdown parser implementation in pure, native Python. In addition to conforming to the latest verion of the spec (0.28), it: runs 2 to 3 times …

Descriptions (work in progress): https://notes.kuang0.me/mkdocs-commonmark/

Project repository:

GitHub - python-cm/mkdocs-commonmark: A fork of mkdocs that change the...

I moved all forks of relevant projects to a GitHub organization.

This attempt is really a good exercise (in Python) to me. Any feedback is welcome!