yzr-md-to-html

把一份本地 Markdown 转成自包含、双击即可在浏览器浏览的 HTML 文件。默认套一套 深色阅读主题（GitHub-dark 风格，纯深色），自带侧边栏目录 TOC、离线代码 语法高亮（Pygments），并按需自动启用数学公式（KaTeX）与 Mermaid 图表：只有源文件 里真出现 $ 才会挂 KaTeX CDN；Mermaid 代码块默认转成 ASCII 图离线渲染（无需联网）， 只有转换失败 / 不支持的图类型才回退到 Mermaid CDN。普通文档零额外网络请求。

输入 / 输出

• 输入：一个 .md 文件，或一个目录（批量转该目录下所有 *.md）
• 输出：单个自包含 .html（CSS 与 Pygments 高亮全部内联，公式 / 图表按需渲染）
• 参数与默认值以 python3 scripts/md_to_html.py --help 为单一来源（argparse 定义，此处不 重抄）：文件输入默认生成同名 .html；目录输入默认就地生成，--title 默认取首个 # 一级标题再退回文件名

自定义模板可用变量（--template 传入的 Jinja2 模板里用，不在 --help 范围内）： {{ content }}（正文 HTML）、{{ toc }}（目录 HTML）、{{ styles }}（默认主题 CSS）、 {{ pygments_css }}（代码高亮 CSS）、{{ title }}、{{ lang }}， 以及布尔开关 {{ has_math }} / {{ has_mermaid }} / {{ has_toc }}（控制是否挂对应 CDN / 侧边栏）。