mdformat-gfm-alerts

An mdformat plugin for <placeholder>

mdformat Usage

Add this package wherever you use mdformat and the plugin will be auto-recognized. No additional configuration necessary. See additional information on mdformat plugins here

Pre-Commit

repos:
  - repo: https://github.com/executablebooks/mdformat
    rev: 0.7.18
    hooks:
      - id: mdformat
        additional_dependencies:
          - mdformat-gfm-alerts

pipx/uv

pipx install mdformat
pipx inject mdformat mdformat-gfm-alerts

Or with uv:

uv tool run --from mdformat-gfm-alerts mdformat

HTML Rendering

To generate HTML output, gfm_alerts_plugin can be imported from mdit_plugins. For more guidance on MarkdownIt, see the docs: https://markdown-it-py.readthedocs.io/en/latest/using.html#the-parser

from markdown_it import MarkdownIt

from mdformat_gfm_alerts.mdit_plugins import gfm_alerts_plugin

md = MarkdownIt()
md.use(gfm_alerts_plugin)

text = "... markdown example ..."
md.render(text)
# <div>
#
# </div>

Contributing

See CONTRIBUTING.md