docrev

一个让 Markdown 与 Word 用户无缝协作的文档版本控制工具。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:docrev。
它的用途是:一个让 Markdown 与 Word 用户无缝协作的文档版本控制工具。
完整的 Skill 内容见:https://321skill.com/skills/docrev/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我需要和几位使用 Word 的教授合作修改一篇论文,如何管理版本?” 它会介绍 docrev,让你用 Markdown 写作并用 `rev build docx` 分享 Word 稿。收到批注后,用 `rev sync` 将意见导回 Markdown,在终端内处理完再重新生成终稿。

介绍

docrev 解决了学术写作和团队协作中常见的格式混乱问题。当你在 Markdown 中撰写文档并与习惯使用 Microsoft Word 的审稿人合作时,来回修改会产生多个版本混乱的 .docx 文件,导致版本失控和格式漂移。

它通过命令行工作流,让你始终以 Markdown 作为单一事实来源。你可以使用 rev build 命令将包含图表、公式和交叉引用的 Markdown 文档编译成 Word 或 PDF 格式进行分享。当收到带有批注和修订的 Word 文件后,使用 rev sync 命令即可将审阅者的所有反馈(评论和修订)同步回你的 Markdown 源文件中。

这个工具非常适合需要撰写技术文档、学术论文、项目报告等内容创作者和学术研究者,尤其是那些希望利用 Git 进行版本控制,但又不得不与使用 Word 的同事或期刊编辑协作的场景。

使用前需要确保系统已安装 Node.js 18+ 和 Pandoc。对于需要复杂排版(如数学公式、交叉引用、特定期刊样式)的 PDF 生成,建议额外安装 LaTeX;对于简单文档,可以在配置中指定非 LaTeX 引擎(如 typst)来生成 PDF。

核心特点

与仅提供 Markdown 到 Word/PDF 转换的工具不同,docrev 的核心在于其双向同步能力,能将 Word 中的审阅意见和修订内容精准导回 Markdown 源文件,并支持在终端内进行回复和接受/拒绝操作,真正实现了以纯文本为中心的协作闭环。

注意事项

不适合需要直接在 Word 中进行复杂排版和样式设计的场景,其核心仍是基于 Markdown 的文档工作流。

常见问题

docrev 能处理 Word 中的所有格式吗?

主要处理文本、评论、修订、图表、公式和交叉引用等核心学术元素,复杂 Word 样式可能无法完美保留。

必须安装 LaTeX 吗?

生成简单 PDF 可不装,用 typst 等引擎;但如需支持数学公式和期刊模板的复杂 PDF,则需 LaTeX。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/docrev/raw/index.md 读取 docrev 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。