sid-kap / recommonmark

A markdown parser for docutils

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

recommonmark

A docutils-compatibility bridge to CommonMark derived from remarkdown.

Why a bridge?

Many python tools (mostly for documentation creation) rely on docutils. But docutils only supports a ReStructuredText syntax.

For instance this issue and this StackOverflow question show that there is an interest in allowing docutils to use markdown as an alternative syntax.

Why another bridge to docutils?

recommonmark uses the python implementation of CommonMark while remarkdown implements a stand-alone parser leveraging parsley.

Both output a docutils document tree and provide scripts that leverage docutils for generation of different types of documents.

Acknowledgement

recommonmark is mainly derived from remarkdown by Steve Genoud and leverages the python CommonMark implementation.

About

A markdown parser for docutils

License:MIT License


Languages

Language:Python 100.0%