写论文的人大概都经历过这件事导师突然说“期刊只收 LaTeX 投稿”或者看着 Word 里已经排好的几十页稿子想到要重新转成 LaTeX心里直接凉了半截。最近我在折腾一个开源 Skill专门用来把 Word 论文一键转成 LaTeX并且可以适配不同期刊模板。这套方案的核心不是让工具自动帮你“变魔术”而是把 Word 文档拆成 LaTeX 能理解的元素——标题层级、公式、表格、图表、参考文献——再按目标期刊模板重新组织。对手里已经有完整 Word 稿件、又没时间手写 LaTeX 的科研党来说这是目前比较值得试的一条路。这个 Skill 本质上是一组给 Codex 使用的结构化指令和辅助模板。你只需要把 Word 文档交给它告诉它用哪个期刊模板它就会生成.tex文件、导出图片、处理参考文献然后帮你执行编译。下面按实际落地顺序把环境准备、转换流程、质量验收、报错排查和边界限制都拆开讲。1. 先搞清楚Word 转 LaTeX 卡在哪这个 Skill 补了什么1.1 为什么手动转换和在线工具都不够用Word 和 LaTeX 的排版逻辑完全不同。Word 是“所见即所得”LaTeX 是“内容与样式分离”。这个差异导致直接转换时最容易翻车的四类内容第一是公式。Word 里的公式本质上是 OMML 对象不是普通文字普通解析器读出来就是一坨乱码更别说保持分式、根号、求和符号的层级结构。第二是表格。合并单元格、跨页行、双线表头、指定列宽这些在 Word 里是“画出来”的在 LaTeX 里要变成tabularx、longtable、booktabs这类语法单纯文本提取根本表达不了。第三是交叉引用。Word 里的“图 1”“表 2”“文献 [3]”很多时候是域代码转换后编号和链接经常对不上。第四是期刊模板。每个期刊的模板不一样elsarticle、IEEEtran、ACM各有各的排版约定在线工具能转出文本就算不错模板适配基本没有。手动转倒是可行但成本太高。一篇 30 页、带公式带表格的论文熟悉 LaTeX 的人手写也要两三天不熟悉的话光调宏包就能折腾一周。所以问题不是“能不能转”而是“怎么把转换成本降下来同时保证质量可验收”。1.2 这个 Skill 本质上是什么Codex 本身是 OpenAI 的编程智能体它的 Skill 机制可以理解成给智能体准备一个“工作手册”手册里写清楚这个技能解决什么问题、接受什么输入、按什么步骤执行、每一步的输出要检查什么。对应到 Word 转 LaTeX 这个场景Skill 目录里通常包含这几类东西paper2latex-skill/ ├── SKILL.md # 技能描述和执行步骤 ├── templates/ │ ├── elsevier/ │ │ ├── elsarticle.cls │ │ └── template.tex │ └── ieee/ │ └── IEEEtran.cls ├── examples/ │ └── sample_output.tex └── scripts/ ├── extract_docx.py # 解析 Word 文档 └── check_output.py # 检查生成的 tex 是否完整实际运行时Codex 会先读SKILL.md知道自己该做什么。然后解压.docx文件读取段落、样式、题注这些结构信息而不是把整篇文档当纯文本复制。Word 里的“标题 1”会被映射成\section{}正文段落会变成普通段落图片会被导出到 figures 目录公式则从 OMML 转换成 LaTeX 数学语法。期刊模板适配靠的是 templates 目录里的.cls、.sty和模板说明Codex 会按照模板要求组织导言区和宏包加载。1.3 适合谁不适合谁我先说这个方案适合什么人Word 论文已经写完期刊要求 LaTeX 投稿手里有期刊提供的模板自己也愿意花时间做人工校对。你至少要会编译一次 LaTeX、看得懂编译日志里的常见报错不然 Skill 生成的初稿出了问题你都不知道该从哪里下手。不适合的情况也有。完全没碰过 LaTeX 的建议先补一点基础再来用论文里大量截图公式、扫描页面的Skill 做不了 OCR输入质量就决定了输出上限期刊模板特殊到要手写大量自定义宏包的Skill 给出的初稿只能当参考。它解决的是“从 Word 初稿到可编译 LaTeX 版本”这个阶段不是“排版一锤定音”。2. 运行环境跑起来前先把这四样东西备齐2.1 Codex CLI 和运行账号Codex 本身需要安装 CLI并完成登录。这一步最常见的坑是启动时报错unable to locate the codex cli binary. set codex cli path or ensure ...这个报错通常出现在桌面端或编辑器插件调用 Codex 时系统在 PATH 里找不到codex命令或者 Codex 设置里指定的 CLI 路径不对。处理顺序很简单先在终端跑一遍codex --version确认命令行本身能启动能启动再去排查插件和客户端的路径配置不能启动就先解决 CLI 安装问题。另外现在有不少人把 Codex 的接口配置成其他模型来用网上常说的“codex 接入 deepseek”就是这个思路。Skill 的指令结构不依赖具体模型但不同模型对超长文档和格式指令的遵循程度差别很大。换了模型效果必须重新实测不能只看 Skill 名字就认定结果一致。2.2 LaTeX 发行版需要安装 TeX Live、MacTeX 或 MikTeX 中的一个。我个人建议不管在哪个系统都把 XeLaTeX 作为默认编译器。理由很直接Word 转出来的中文论文很常见而中文支持在 LaTeX 里最容易出问题。很多人遇到“doxygen latex 无法处理中文”这类报错本质不是模板问题而是没用 XeLaTeX 编译或者缺少ctex、xeCJK这些中文字体宏包。Windows 下 TeX Live 装完整版最省心缺点是占磁盘空间比较大装的时候可以把不需要的宏包语言包去掉一部分。Mac 下 MacTeX 也一样完整版占空间但对论文写作来说宏包齐全比省几个 GB 重要得多。如果本机不想装太重可以用 Overleaf 在线编译但要注意Skill 生成的.tex文件里如果用了特殊宏包先确认 Overleaf 的 LaTeX 版本支持否则线上编译会报错然后你分不清到底是模板问题还是环境问题。2.3 Skill 文件放在哪里Skill 下载下来之后一般不是一个单一文件而是一个目录里面有SKILL.md和其他辅助资源。安装方法通常是把这个目录放到 Codex 配置的 skills 目录下路径一般在用户目录下的.codex里也可能在设置界面里手动指定。放好后一定要重启 Codex再让它列出可用 Skill确认新技能真的加载成功。这一步很多人会忽略结果对着 Codex 喊了半天“用那个转换 Skill”它根本没加载自然也不会按你的要求执行。这里没有固定绝对路径因为 Codex 版本不同默认位置可能不同但“复制到 skills 目录、重启、验证可见”这个顺序是稳定的。2.4 准备一份最小测试文档不要一上来就拿 30 页的正式论文测试。第一次建议新建一个只有 2 到 3 页的.docx内容包含一个章标题、两段正文、一个公式、一个三行三列且带合并单元格的表格、一张图片、一条参考文献。用最小样例跑通再处理真实论文。这样做的好处是能把“工具没装对”“Skill 没加载”“文档太复杂”三种问题区分开。如果最小样例都能转换并编译成功真实论文出问题大概率是文档内容本身有特殊情况如果最小样例就报错那就要回到环境和 Skill 加载上排查。3. 实操流程从零到第一次编译通过3.1 清洗 Word 输入文档转换前先把 Word 文档清洗一遍这一步能省掉后面大量返工。先确认格式是.docx如果是老的.doc先另存为.docx因为.doc的解析兼容性差很多。然后把批注、修订痕迹全部接受或删除这些东西会让 Codex 误以为是正文内容。最后检查标题样式Word 里如果用了“标题 1”“标题 2”这种内置样式转换最稳定如果是手动加粗、手动编号转换后层级会乱。Word 里的手动编号和自动编号混用是转换后最乱的情况建议先把手动编号统一成自动列表格式。图片部分也要看一眼。如果图片是嵌入在文本框里的或者被压缩过最好在 Word 里先导出成独立文件确保原图分辨率还在。公式建议在 Word 里逐个检查是否都是“公式对象”而不是截图。3.2 安装 Skill 并确认加载假设你已经把 Skill 目录准备好安装命令可以按这个思路执行# 示例把 Skill 放到 Codex 的 skills 目录 mkdir -p ~/.codex/skills cp -r paper2latex-skill ~/.codex/skills/ # 重启 Codex 后列出已加载的 Skill codex list-skills注意这里只是通用示例具体路径要以你本机 Codex 版本为准。确认加载成功的标准是 list 里能看到这个 Skill 的名字或者在 Codex 的交互界面里能触发它的描述。3.3 发起转换任务加载成功后给 Codex 的指令可以这么写请使用 paper2latex 这个 Skill把 ./papers/我的论文.docx 转换为 LaTeX。 目标期刊模板是 templates/elsevier 下提供的 elsarticle。 先分析文档结构再生成 main.tex、figures 目录和 references.bib 最后用 xelatex 编译一次把编译错误和警告列出来。指令里最好包含四个信息输入文件路径、目标模板路径、期望的输出结构、期望的验证动作。不要只丢一句“帮我转成 LaTeX”那会让 Codex 自行决定很多东西结果不可控。Codex 收到指令后会做几件事先解析.docx读出段落、样式、题注然后把文档元素映射成 LaTeX 语法图片导出到 figures 目录公式从 Word 的 OMML 转成数学公式参考文献如果来源是 EndNote、NoteExpress 这类工具导出的可能需要先转化成 BibTeX。整个过程不是一次性到位的通常会迭代几轮。3.4 第一次编译验证拿到生成的.tex文件后用 LaTeX 发行版编译latexmk -xelatex -synctex1 -interactionnonstopmode main.tex如果不用 latexmk也可以按传统顺序手动编译xelatex main.tex bibtex main xelatex main.tex xelatex main.tex第一次编译过不了很正常不要慌。先看.log文件把第一个真正导致中断的错误找出来缺宏包就装宏包缺文件就补文件路径不对就改路径。这里要提醒一句不要看到报错就把整个日志丢回给 Codex 让它盲改。先自己判断错误类型再决定是让 Codex 继续处理还是自己改 preamble。4. 转换质量怎么判按论文要素逐项验收4.1 标题、正文、列表转换成功的第一个标准不是“能编译”而是“结构对”。先看标题层级Word 的“标题 1”是否对应\section{}“标题 2”是否对应\subsection{}。很多论文里标题是手动加粗的Word 样式名不标准转换后就会变成正文加粗目录自然也是错的。再看列表有序列表、无序列表、缩进层级是否和原文一致。最后看正文里的斜体、粗体、上下标有没有丢失。这一步是纯视觉检查但也是信息量最大的一步因为结构错了后面的引用和目录全都跟着错。4.2 公式公式是最需要人工核对的区域。Word 公式对象转成 LaTeX 数学语法后常见问题包括行内公式和独立公式的切换不对、多行公式变成了单行、\left[ \right]这类自动括号丢失、分式和根号的层级错乱。验收标准是数学语义一致而不是代码能编译。建议把正文里所有公式列出清单逐个对照原文检查一遍。公式多的论文这一步可能是全程最花时间的地方但也是最不能省的地方。Skill 生成的公式初稿通常够用但复杂公式必须人工过一遍尤其是带求和、积分上下限、矩阵对齐的场景。4.3 表格和图片表格是另一个重灾区。Word 表格的双线边框、合并单元格、指定列宽转到 LaTeX 之后经常面目全非。网上很多人搜“word 表格双线变单线”其实说的就是排版工具在做格式迁移时对表格线条的处理不一致。Skill 转出来的表格也需要检查内容有没有错位、列宽是否溢出页面、合并单元格是保留还是丢失了、跨页长表格有没有正确处理。图片检查几个点figures 目录里是否包含全部图片文件、图片文件是否都真实存在、相对路径是否写对了、每个\caption{}是否和原始题注一致、正文里的“图 1”“图 2”引用是否变成了\ref{}。如果 pdflatex 编译时图片报错检查扩展名和格式支持情况必要时统一转成 PDF 或 PNG 再引入。4.4 参考文献和交叉引用参考文献的转换质量最影响投稿效率。Word 里的文献管理软件导出 BibTeX 时经常出现 key 缺失、作者名不完整、期刊名缩写不一致的问题。Skill 生成的references.bib只能算初稿投稿前必须逐条核对。如果期刊指定了编号引用格式还要确认\bibliographystyle{}配置正确。验收标准是正文中的引用编号和文末参考文献列表能对应上图、表、公式的交叉引用编号在编译两遍后稳定正确。第一次编译完成不代表引用没问题LaTeX 的交叉引用需要编译多次才会稳定。这里可以直接用下面这张表做检查清单检查项重点看什么通过标准标题层级章节编号、目录与 Word 原文一致公式行内/独立、多行对齐、括号数学语义一致表格列宽、合并单元格、线型不溢出、不错位图片路径、格式、题注全部加载且编号正确参考文献BibTeX 字段、key 唯一性正文引用与文末对应5. 常见报错和排查顺序5.1 一句话原则先看日志再改文件遇到 LaTeX 问题不要急着改代码。LaTeX 的报错有层级缺宏包、缺文件、字体找不到、语法错误、长度溢出处理方式完全不一样。latexmk -interactionnonstopmode可以让编译遇到错误时不暂停但定位问题还是要靠.log文件里的上下文。常见的一个误区是只看第一条 error。有时候第一条错误只是前面某个宏包没加载引起的连锁反应真正的问题在更早的 warning 里。所以我一般会先搜.log里带感叹号的段落再看最后一个致命错误是什么然后反推原因。5.2 Codex 层问题Codex 本身出问题特征很明确。如果 Skill 加载不出来先重启 Codex确认目录位置再运行list-skills验证。如果出现unable to locate the codex cli binary基本就是 PATH 或 CLI 路径设置的问题先跑codex --version确认命令行可用再去调整桌面端和插件的配置。如果转换任务跑到一半卡住不要马上判断是 Skill 不行先看输入文档是不是太大、输出目录有没有写入权限、是不是一次让它处理了太多章节。长文档可以拆成几个部分分别转换再手动合并。5.3 LaTeX 编译层问题编译层的问题我按频率从高到低列一下中文乱码或中文不显示先确认编译器是不是 xelatex正文区有没有加载ctex宏包或xeCJK。很多“doxygen latex 无法处理中文”的报错就是编译命令没选对。缺宏包根据日志提示安装或检查模板自带的宏包列表。字体找不到Windows 和 Mac 的中文字体名不一样可以用ctex的fontset参数指定。表格溢出检查列宽设置和是否用了tabularx、longtable。图片找不到检查大小写、相对路径和扩展名。5.4 按顺序排查清单最后给一个通用排查顺序遇到问题可以按这个走现象先看什么再处理什么编译直接失败.log最后几行缺宏包、缺文件、语法错误中文乱码编译命令和导言区换 xelatex加载 ctex表格溢出表格环境和列宽换 tabularx / longtable公式错位转换后的公式代码手动重排复杂公式Codex 找不到codex --version和 PATH调整 CLI 路径配置6. 边界与进阶这个方案不能干什么6.1 输入质量决定输出上限必须说清楚一件事这个 Skill 针对的是“已经存在的 Word 文档”它解决不了输入本身的问题。扫描版 PDF 转成 Word 再转 LaTeX效果取决于中间 OCR 的质量Skill 本身不做 OCR。论文里如果大量截图公式那这些公式只能人工录入因为图片里没有可解析的数学结构。Word 里遗留批注和修订痕迹不清洗会污染正文。文档里用了不标准的内嵌对象、文本框、艺术字转换后的位置大概率会乱。这些边界不是 Skill 的缺陷是格式转换的客观限制。6.2 模板适配不是“选个名字”很多人以为模板适配就是让 Codex 选一个模板名字生成出来就能直接投稿。实际不是这样。elsarticle、IEEEtran、ACM这些模板每一个都有自己独特的排版约定甚至同一个期刊的不同分支都会改版。Skill 的 templates 目录只是提供一个起点最终投稿前你需要把自己生成的 PDF 和模板作者提供的 sample 文件做逐页对比。模板的导言区、宏包版本、参考文献样式这些是需要在 LaTeX 侧人工维护的。如果期刊模板发生了更新Skill 里的模板文件也要跟着更新否则生成结果会过时。另外模板适配的修改要落在 LaTeX 侧不要反复回到 Word 里去改否则就失去了一键转换的意义。6.3 批量处理和日常维护如果你手里有多篇论文要转建议用同一套规范同样的 Skill 版本、同样的目标模板、同一种 Word 文档结构。不同文档的样式越接近转换结果越稳定。批量任务不能只看“能不能跑”还要关心失败重试和输出一致性。我一般会先跑一篇完整论文记录下哪些地方需要人工修然后把这套人工修的标准写进转换记录里后续每篇都按同一个清单验收。长期维护时要确定 LaTeX 作为唯一源文件Word 和 LaTeX 两边同步修改是最容易出问题的做法到后面根本分不清哪个版本是最新的。6.4 和其他文档工具的配合这个 Skill 解决的是单方向的 Word 转 LaTeX 需求不要把它当成双向转换器。实际工作流里它经常和这些工具配合VS Code 加 LaTeX Workshop 适合本地编辑和编译报错定位非常直观。Overleaf 适合多人协作但要确认线上 LaTeX 版本能兼容模板宏包。如果后续需要把 LaTeX 转回 Word比如协同办公时别人看不懂.tex可以走 pandoc 的路线但那是另一个工具链。像“vue3 导出 word”“pdf 转 word”这类需求解决思路完全不同不要指望一个 Skill 覆盖所有文档转换场景。我自己用这个 Skill 处理过两篇带公式和表格的论文最深的感受是它能省掉从零手敲 LaTeX 的七成工作量但剩下三成人工校对不能省。公式、参考文献和模板细节AI 生成的初稿不可能完全符合你的期刊要求。真正想把它用起来重点不是看功能列表而是把输入文档洗干净、确认 Skill 加载成功、学会看编译日志、按论文要素逐项验收。先跑通最小样例再处理完整论文比一上来就拿着全部内容猛冲要稳得多。