healthchecks/hc/front/management/commands/render_docs.py

import os

from django.conf import settings
from django.core.management.base import BaseCommand
import markdown


class Command(BaseCommand):
    help = "Renders Markdown to HTML"

    def handle(self, *args, **options):
        extensions = ["fenced_code", "codehilite", "tables"]
        ec = {"codehilite": {"css_class": "highlight"}}

        docs_path = os.path.join(settings.BASE_DIR, "templates/docs")
        for doc in os.listdir(docs_path):
            if not doc.endswith(".md"):
                continue

            print("Rendering %s" % doc)

            src_path = os.path.join(docs_path, doc)
            dst_path = os.path.join(docs_path, doc[:-3] + ".html")

            text = open(src_path, "r", encoding="utf-8").read()
            html = markdown.markdown(text, extensions=extensions, extension_configs=ec)

            with open(dst_path, "w", encoding="utf-8") as f:
                f.write(html)