pandoc_docx_template
为Pandoc提供中文Word模板与Lua过滤器，优化Markdown与DOCX互转。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pandoc_docx_template。 它的用途是：为Pandoc提供中文Word模板与Lua过滤器，优化Markdown与DOCX互转。 完整的 Skill 内容见：https://321skill.com/skills/pandoc-docx-template/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我把这篇Markdown研究笔记转换成Word，要用SCI论文模板，并且标题要自动编号。”，AI会指导你运行命令：`python scripts/md2docx.py 研究笔记.md -o 论文草稿.docx --reference templates/template_sci论文-标题编号.docx`，生成符合SCI风格的Word文档。或者，当你想保留文档中的红色强调文字时，AI会说明该Skill内置的`preserve_font_color.lua`过滤器会自动处理这些样式。
介绍
该Skill旨在解决用户在使用Pandoc进行Markdown与Word DOCX格式互转时，难以获得符合中文排版习惯（如标题编号、列表缩进、SCI论文格式）和保留特定样式（如上标、下标、图片题注、字体颜色）的高质量输出文件的问题。它通过提供一系列预配置的Word参考模板和Lua过滤器，自动化并优化了转换流程。
使用方式非常灵活：对于Markdown转DOCX，用户可以直接运行提供的Python脚本（如md2docx.py），选择所需的中文模板（例如“标题编号-列表第二行顶格”或SCI论文模板），并可附加Pandoc原生选项；对于DOCX转Markdown，则可使用docx2md.py脚本提取内容并保存媒体文件。当无法运行脚本时，也提供了等效的Pandoc命令行供直接调用。
它非常适合需要频繁进行文档格式转换的中文写作者、学术研究者、技术文档工程师以及任何希望利用Markdown的简洁性进行创作，但最终必须提交或协作Word格式文件的团队。无论是撰写毕业论文、科技论文，还是制作需要严格格式规范的企业报告，这个Skill都能显著提升效率。
与仅提供基础转换的普通Pandoc使用方式相比，该Skill的核心价值在于其“开箱即用”的中文排版解决方案。它并非简单地调用Pandoc，而是精心打包了针对中文场景优化的模板和一系列处理HTML标签、图片题注、字体颜色等细节的Lua过滤器，形成了一个完整的、可复用的工作流，避免了用户自行研究和配置复杂排版规则的麻烦。
核心特点
核心区别在于其捆绑了多套针对中文排版细节（如标题是否编号、列表第二行对齐方式、SCI论文格式）深度定制的Word参考模板，并集成了处理HTML标签、图片题注、字体颜色等Markdown中常见但Pandoc默认处理不佳的元素的Lua过滤器，提供了“一站式”的中文友好型文档转换方案。
注意事项
不适合仅需简单基础格式转换、或目标文档格式要求与所提供模板差异过大的场景。
常见问题
如何将Markdown转换成带编号标题的Word？
使用`md2docx.py`脚本并指定`template_标题编号-列表第二行顶格.docx`或`template_标题编号-列表第二行缩进.docx`作为参考模板。
转换后图片标题能自动编号吗？
可以，在转换时使用`lua/image-title-to-caption-add-number.lua`这个独立的Lua过滤器即可为图片添加带编号的题注。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pandoc-docx-template/raw/index.md 读取 pandoc_docx_template 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pandoc-docx-template/raw/index.md（查看排版版本）