SuperAPI AI 工具集

markdown-master

编程与开发

查看项目

更新于 10-15 21:46

技能介绍

用途:面向 Markdown 文档的结构整理与质量检查,适合把草稿整理为正式发布版本,或批量处理多份文档。

主要能力:结构操作(标题升级/降级、按级配置章节编号、插入或更新目录、移除编号);质检(格式 lint、中文排版 zhlint、本地及远程链接检查,可用 --fix 自动修复可修复项);文件级操作(按 h1/h2/h3 拆分、合并多个文件);格式转换(docx、html、txt、pdf,支持目录批量转换与 Word 模板)。编号模板支持十进制、补零、罗马数字、字母、中文数字等占位符,可通过 YAML 配置文件复用。

使用方式:structure.py 与 quality.py 仅用标准库;convert.py 需先安装依赖:pip install python-docx markdown beautifulsoup4 weasyprint pyyaml。典型流程为 lint、zhlint、添加编号、生成目录、链接检查、导出。常用命令如 python scripts/quality.py doc.md lint --fix、python scripts/structure.py doc.md toc generate、python scripts/files.py split doc.md --by h2。操作默认覆盖原文件,可用 -o 输出到新文件。

限制:资料未说明支持的 Markdown 方言、插件、收费及平台信息;PDF 依赖 weasyprint,远程链接检查需显式加参数。