Using the Python Markdown library

For my blog , I use the Pypi package Markdown to convert Markdown files to HTML. All my text is stored as .md.

The library works well once the extensions are all setup. I use the extensions extra, meta, codehilite and markdown_checklist.extension. If you're used to Github markdown. These extensions will give you a similar setup.

The extension codehilite gives you syntax highlights compatible with Pygments.

To get the actual CSS-tags for the HTML, pygments includes a CLI tool for that:

pygmentize -S default -f html -a .codehilite

The -a .codehilite is necessary because of a class name used by codehilite.

I use meta data in the beginning of my Markdown files. For this I use the meta extension.

Snippet for how I use the library:

import markdown

md = markdown.Markdown(extensions=['extra', 'meta', 'codehilite', 'markdown_checklist.extension'])
doc = md.convert(text_md)
args = md.Meta()

References:

• The package documentation: Python-Markdown — Python-Markdown 3.3.3 documentation.
• All available extensions: Extensions — Python-Markdown 3.3.3 documentation.
• Pygments: Pygments · PyPI
• Markdown meta data: Meta-Data — Python-Markdown 3.3.3 documentation

• Moved my blog.