用途:把 Markdown 转换为可分享的文档,支持 HTML、Word(DOCX)和 PDF 三种格式。当用户调用 /render,或要求转换、导出、渲染 .md 文件时使用。
主要能力:输入支持 GitHub 风格 Markdown,以及 YAML front matter(title、subtitle、author、date 会成为文档页眉)、脚注、$math$ 和智能引号。HTML 与 PDF 采用编辑风格设计,正文用 Charter、标题与标签用 Inter,单一墨蓝强调色,字体缺失时回退到 Georgia/系统字体;HTML 自包含(内嵌 CSS 与图片)并适配明暗模式;PDF 由同一 HTML 打印生成,带打印尺寸和页码。DOCX 使用内置 assets/reference.docx(Georgia 正文、Aptos 标题、Consolas 代码)。相对图片路径从源文件所在文件夹解析。
使用方式:命令为 uv run scripts/render.py <file.md|dir> [more…] [options]。选项:-f html,docx,pdf(默认三种全出)、-o DIR(默认输出到各源文件旁)、-r(递归目录)、--toc、--css FILE(HTML/PDF 样式)、--reference-docx FILE(Word 样式)。/render 无参数时使用对话涉及的 Markdown 文件;若有多个可能文件则询问,若没有则索要路径。用户指定的格式或输出目录需遵从(如“只要 PDF”则用 -f pdf)。输出会覆盖源文件旁同名的 .html/.docx/.pdf;若某文件已存在且非本会话此前由该技能生成,覆盖前应提示或改用 -o。
依赖与限制:仅需 uv(pandoc 随 pypandoc-binary 依赖内置);生成 PDF 还需 Chrome/Chromium/Edge 或 WeasyPrint。脚本按输出打印 ok/FAIL,任一失败则以非零退出;应报告输出路径和失败项,仅在用户要求或明显需要时打开或分享文件。修改外观可编辑 assets/style.css 或传 --css;更换 Word 样式可传 --reference-docx(--init-reference-docx ref.docx 可写出 pandoc 默认样式作为起点),修改调色板或字体后可用 uv run scripts/build_reference_docx.py 重建内置模板。