跳转到主要内容

一个用于admonitions的mdformat插件。

项目描述

mdformat-admon

Build Status PyPI version

一个用于 admonitions 的mdformat插件,一组支持新admonition语法的辅助工具,以及用于渲染admonition HTML的工具。

mdformat 使用方法

在任何使用mdformat的地方添加此包,插件将自动识别。无需额外配置。有关mdformat插件的更多信息,请参阅此处

Pre-Commit

repos:
  - repo: https://github.com/executablebooks/mdformat
    rev: 0.7.16
    hooks:
      - id: mdformat
        additional_dependencies:
          - mdformat-admon

pipx

pipx install mdformat
pipx inject mdformat mdformat-admon

HTML 渲染

要生成HTML输出,可以从mdit_plugins导入python_markdown_admon_plugin。将来还将添加更多插件。有关MarkdownIt的更多指导,请参阅文档: https://markdown-it-py.readthedocs.io/en/latest/using.html#the-parser

from markdown_it import MarkdownIt
from mdformat_admon.mdit_plugins import python_markdown_admon_plugin

md = MarkdownIt()
md.use(python_markdown_admon_plugin)

text = '!!! note ""\n    *content*'
md.render(text)
# <div class="admonition note">
# <p><em>content</em></p>
# </div>

可扩展性

由于admonition语法在各种实现之间差异很大,因此该包在mdformat_admon.factories下提供一组用于构建新admonition解析器的辅助工具。

查看不同劝诫格式在此测试文件中的处理方式: ./tests/pre-commit-test.md

贡献

查看 CONTRIBUTING.md

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源代码分发

mdformat_admon-2.0.6.tar.gz (13.0 kB 查看哈希值)

上传时间 源代码

构建分发

mdformat_admon-2.0.6-py3-none-any.whl (9.6 kB 查看哈希值)

上传时间 Python 3

支持者:

AWSAWS 云计算和安全赞助商 DatadogDatadog 监控 FastlyFastly CDN GoogleGoogle 下载分析 MicrosoftMicrosoft PSF 赞助商 PingdomPingdom 监控 SentrySentry 错误日志 StatusPageStatusPage 状态页面