search

readthedocs / recommonmark

A markdown parser for docutils
https://recommonmark.readthedocs.io/
MIT License
340 stars 252 forks source link

Code block custom language transformer #136

Closed mghh closed 2 years ago

mghh commented 5 years ago

Hi,

in some projects we document our code with plantuml diagrams embedded in markdown. To assist the creation of theses diagrams we use an atom editor extension which does live preview of plantuml.

To extend our workflow - the whole documentation is done with sphinx - we would like to have an extension mechanism in recommonmark to hook in a custom code block language transformer.

This pull request shows an implementation we are currently using in our fork of recommonmark. Maybe this code could be merged into upstream.

Best regards, Martin

bachp commented 5 years ago

This would be very helpful as it would allow plantuml diagrams in markdown that render nicely in Gitlab and in Sphinx.