mirror of
https://github.com/vale981/recommonmark
synced 2025-03-05 10:01:39 -05:00
No description
|
||
---|---|---|
recommonmark | ||
.gitignore | ||
license.md | ||
README.md | ||
setup.cfg | ||
setup.py |
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.