论文从 Word 转成 LaTeX是不少科研党都绕不过去的一道坎。手动复制粘贴一个小时只是基础操作公式、表格、图片换了环境要重新排版用在线工具转换完格式又跟期刊模板对不上。OpenAI 开源的 Codex CLI 提供了另一种做法让 AI 在本地读取文档、执行命令、反复编译再通过 Skill 机制把“Word 论文转 LaTeX 并适配期刊模板”这套流程固化下来变成一条可重复执行的自动化流水线。下面从零演示如何准备环境、编写一个 docx-to-latex-paper Skill把一篇带标题、图片、表格和参考文献的 Word 论文转成可编译的 LaTeX 项目并说明如何适配常见期刊模板。这套流程适合正在准备投稿的科研人员、帮助他人排版的技术支持人员以及想用 Codex CLI 管理重复性格式转换任务的开发者。所谓“一键”不是第一次使用就完全不用配置而是把整套规则预置成 Skill 后后续每次只需要一句话触发。1. 先理清 Word 转 LaTeX 的难点和自动化思路1.1 手动转换为什么容易翻车Word 是可视化排版格式藏在段落属性和样式里LaTeX 是声明式排版结构、样式和内容完全分离。两者之间不是“复制粘贴再改改字体”的关系而是一次结构重建。手动转换时以下内容最容易消耗时间标题层级辨认Word 里用加粗、字号、编号手动控制的标题到了 LaTeX 必须还原成\section、\subsection等命令。公式格式MathType 公式、Word 自带公式编辑器、公式图片三种形态需要三种处理方式。表格结构Word 里常见的网格线、双线、合并单元格在 LaTeX 中通常要改成booktabs三线表列宽和对齐方式都需要重新定义。图片引用Word 中图片是嵌入的浮动对象导出 LaTeX 后图片文件、路径、编号和交叉引用都要重建。参考文献手动排序的引用列表要转成.bib文件再让 BibTeX 自动编号。特殊字符_ % # $ { }这些字符在 LaTeX 中有特殊含义不转义会导致编译失败。下面这张表可以快速看出一篇 Word 论文在转入 LaTeX 时要经历哪些变化。Word 中的常见状态转到 LaTeX 时要做的处理标题靠加粗和字号区分恢复为\section、\subsection等层级命令公式用 MathType 或公式编辑器转换为 LaTeX 数学语法编号方式统一表格使用网格线和双线改为booktabs三线表重设列宽与对齐图片是居中嵌入的浮动对象使用figure环境并设置\caption、\label引用手动编号使用 BibTeX 或 biblatex 自动编号章节交叉引用写“见图1”使用\ref、\autoref自动更新引用如果论文只有几千字、没有公式手动转换还能接受。一旦进入多图、多表、多公式的真实投稿场景手动方案不仅效率低还容易出现“正文改完了图表编号忘了更新”这类低级错误。1.2 为什么 Codex 适合做这个转换Codex CLI 是 OpenAI 开源的命令行 AI 助手它能在终端中读取文件、写文件、执行 shell 命令并且根据运行结果继续调整自己的操作。这正好匹配“Word 转 LaTeX”这类多步骤任务先解析文档结构再生成.tex接着编译看到报错后修改最后输出可用的 PDF。Codex 的 Skill 机制解决的是“复用”问题。没有 Skill 时每次都要在对话里重新描述转换规则、模板要求、检查标准有了 Skill这些内容被固化到本地目录中的SKILL.md和参考资料里。用户只需要写一句“使用某个 Skill 处理某个文件”Codex 就会按预置流程执行。这个过程的价值不只是省掉一条长提示词规则可维护期刊模板调整时只改 Skill 中的参考文件即可。团队可共享把 Skill 目录放入 Git 仓库成员克隆后就能使用同一套转换标准。结果可复现同一份文档在不同时间转换执行逻辑一致不会因为一次对话状态不同而飘忽。本地执行未发表的论文稿件不需要上传到第三方在线转换服务降低隐私顾虑。1.3 这套方案的边界必须承认不是所有 Word 文档都能被自动转换成 100% 还原的 LaTeX。以下场景需要人工介入公式密集且混用了 MathType、OMML、图片三种形式的文档含有大量合并单元格、复杂嵌套表格的文档模板本身不规范缺少样例.tex和宏包的期刊Word 中完全通过手动空格对齐的“伪表格”。所以把 Codex 定位成“自动完成 80% 重复劳动剩下 20% 由人核对”是最稳妥的使用心态。下面进入环境准备。2. 环境准备Codex CLI、LaTeX 发行版与 pandoc2.1 安装 Codex CLICodex CLI 的安装方式在不同版本之间有差异常见途径有两种。如果官方提供 npm 包可以执行npm install -g openai/codex如果更习惯直接使用发行版二进制可以从 GitHub Releases 页面下载当前系统对应的压缩包解压后把可执行文件加入PATH。也可以克隆官方仓库后按 README 说明从源码构建。具体方式以官方 README 为准不要照搬一个固定的安装命令到所有系统。安装后先验证版本codex --version首次启动时根据提示完成账号登录或 API Key 配置。不同版本的鉴权方式有差异直接跟随终端提示即可。配置完成后可以执行一条简单命令测试codex 列出当前目录下的文件如果 Codex 能正确读取目录并描述文件说明基础功能可用。2.2 安装 LaTeX 发行版LaTeX 编译器是整个流水线的终点建议按操作系统选择发行版。操作系统推荐发行版说明WindowsTeX Live 或 MiKTeXTeX Live 宏包完整安装时间长MiKTeX 按需安装宏包占用小macOSMacTeX官方 GUI 安装包内含 TeX Live、TeXShop 等工具Linuxtexlive-full多数发行版可通过包管理器安装宏包齐全跨平台Overleaf在线编译适合协作但不适合需要本地执行的自动化流程安装完后验证两个关键命令xelatex --version latexmk --version这里特意使用xelatex而不是pdflatex因为中文学术论文场景下xelatex配合ctex宏包对中文的支持最省心。后面示例也统一用latexmk -xelatex作为编译命令。2.3 安装 pandoc 作为转换过渡工具pandoc 是文档格式转换的瑞士军刀。完整方案不是让 Codex 从零读取二进制.docx文件而是先用 pandoc 把.docx转成一份基础.tex草稿再让 Codex 在此基础上做语义调整、模板适配和编译修复。安装 pandocpandoc --versionmacOS 可以使用brew install pandocLinux 使用系统包管理器安装pandocWindows 使用安装包或包管理器。pandoc 版本之间差异不大但转换效果可能受版本影响建议保持最新稳定版。2.4 配置 VS Code 和 LaTeX Workshop推荐使用 VS Code 加 LaTeX Workshop 扩展进行后续编辑。安装扩展后在settings.json里配置一套 xelatex 编译链{ latex-workshop.latex.recipes: [ { name: latexmk (xelatex), tools: [ latexmk (xelatex) ] } ], latex-workshop.latex.tools: [ { name: latexmk (xelatex), command: latexmk, args: [ -xelatex, -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] } ] }配置完成后在 VS Code 中打开.tex文件点右上角 TeX 图标即可启动编译。这个配置里的-file-line-error很重要错误信息会精确到文件行号后面排查问题时能省很多时间。到这里环境中的三根支柱已经就绪Codex 负责调用 AI 能力和执行命令行pandoc 负责基础转换LaTeX 环境负责编译和报错。可以先做一个总检查codex --version xelatex --version pandoc --version latexmk --version四个命令都没有报错再进入 Skill 编写阶段。3. 编写一个可复用的 docx-to-latex-paper Skill3.1 没有 Skill 时转换流程有多难重复如果直接在 Codex 对话里手动描述规则每次要写的信息非常长Word 文件在哪里、图片怎么处理、表格要不要转三线表、参考文献用哪个样式、编译命令是什么、报错后怎么办。这些内容写一遍就够繁琐更不用说每次换文档都要重写一遍。Skill 的本质就是把这些指令和领域知识放到固定目录中让 Codex 在用户触发时自动读取。你只需要在对话里说“使用 docx-to-latex-paper 处理 paper.docx”剩下的规则全部由 Skill 提供。3.2 建立 Skill 目录Codex 的 Skill 通常放在用户目录的.codex/skills下常见结构如下~/.codex/skills/docx-to-latex-paper/ ├── SKILL.md └── references/ ├── conversion-rules.md └── template-checklist.md不同版本的 Codex 对 Skill 的识别位置可能有差异如果~/.codex/skills不存在先查看当前版本官方文档确认目录。也可以用一条命令创建目录mkdir -p ~/.codex/skills/docx-to-latex-paper/references3.3 编写 SKILL.md 主文件SKILL.md是 Skill 的入口包含元信息、适用场景、执行步骤和结果标准。下面是适合作为起点的一个版本--- name: docx-to-latex-paper description: 将 Word 论文转换为 LaTeX 源码并适配指定期刊模板。 --- # Word 论文转 LaTeX ## 适用场景 - 输入.docx 格式的论文稿件 - 输出可编译的 LaTeX 项目目录 - 目标符合指定期刊模板的排版要求 ## 转换前检查 1. 确认 .docx 文件存在且可正常打开。 2. 确认 pandoc、xelatex、latexmk 已安装。 3. 确认期刊模板目录存在包含 .cls 或 .bst 文件。 ## 执行步骤 1. 使用 pandoc 将 .docx 转换为基础 .tex 草稿。 2. 解压 .docx 检查 word/document.xml 中的标题样式。 3. 将 Word 内置样式映射为 LaTeX 章节命令。 4. 导出 docx 内置图片到 images 目录并修正路径。 5. 将表格转换为 booktabs 三线表必要时使用 tabularx。 6. 检查公式语法统一使用 equation 或 align 环境。 7. 应用期刊模板替换 documentclass 和相关宏包。 8. 使用 latexmk -xelatex 编译修复所有 error。 ## 结果标准 - 编译无 error。 - 图片、表格编号连续交叉引用正确。 - 参考文献格式与期刊模板一致。 - PDF 中文字体正常显示无方框乱码。description字段是 Codex 判断何时使用该 Skill 的关键要写得像一条普通功能描述而不是内部代号。执行步骤中的每一步都应当让 Codex 在转换时真正执行而不是只读一遍。3.4 编写转换规则参考文件references/conversion-rules.md用来存放具体的格式规则。主文件负责流程参考文件负责细节这样后续修改规则时不需要改动主逻辑。# LaTeX 转换规则 ## 标题映射 - Word 样式 Heading 1 - \section{} - Word 样式 Heading 2 - \subsection{} - Word 样式 Heading 3 - \subsubsection{} ## 表格 - 优先使用 booktabs避免竖线。 - 列宽超出 \textwidth 时使用 tabularx。 - 单元格内容含特殊字符时做转义。 - Word 中常见的表格双线统一改成三线表结构。 ## 图片 - 将所有图片复制到 images/ 目录。 - 使用 \includegraphics 时省略扩展名。 - 主文件设置 \graphicspath{{images/}}。 - 图片必须使用 figure 环境并补全 \caption 和 \label。 ## 公式 - 独立公式使用 equation 环境需要多行时使用 align。 - 行内公式使用 \( ... \)避免使用 $$ ... $$。 - MathType 公式需要先转换成 LaTeX 语法无法直接读取时询问用户。 ## 特殊字符 - _ % # $ { } 在普通文本中需要转义。 - 反斜杠本身用于命令不要直接复制 Windows 路径到 LaTeX 中。这个文件解决了大多数转换“半成品”的问题。比如 Word 表格经常是网格线加重复表头转换后容易出现竖线过多、列宽失衡规则中直接写“避免竖线、用三线表”Codex 执行时就有了明确依据。3.5 编写模板检查清单参考文件references/template-checklist.md用于保存期刊模板相关的核对项# 期刊模板适配检查清单 ## 文档类 - [ ] documentclass 是否替换为模板提供的类名 - [ ] 是否需要 twocolumn、manuscript 等选项 - [ ] 模板提供的 .sty 是否已全部加载 ## 标题与作者 - [ ] 标题是否使用模板提供的 title 命令或环境 - [ ] 作者、单位、邮箱是否填写正确 ## 摘要与关键词 - [ ] 是否使用 abstract 环境 - [ ] 关键词格式是否与模板一致 ## 章节与图表 - [ ] 章节标题是否按模板格式显示 - [ ] 图表标题编号是否连续 - [ ] 表格是否使用三线表样式 ## 参考文献 - [ ] bibliographystyle 是否使用模板提供的 .bst - [ ] BibTeX 是否能无警告编译 ## 中文支持 - [ ] 使用 xelatex 编译 - [ ] 是否加载 ctex 宏包这些检查项不是给读者看的而是写给 Codex 的指令。Skill 执行完转换后Codex 会逐项核对并报告未通过项。3.6 验证 Skill 是否被识别在 Codex 交互界面中先确认 Skill 被加载codex然后在对话里输入列出当前可用的 skill如果 Skill 创建成功列表中应该能看到docx-to-latex-paper。看不到时先检查目录名是否为skills、SKILL.md文件名大小写是否正确再查看官方文档确认存放位置。值得注意的是Skill 文件修改后可能需要重启 Codex 进程才能生效。如果发现修改不生效先重启再测试。4. 实测把一篇带图表的 Word 论文转换成 LaTeX4.1 准备一份测试 Word 文档为了验证整个流程先准备一个测试目录和示例文档mkdir -p paper-work cd paper-work测试文档不必用真实论文可以构造一个包含标题、摘要、两个章节、一张图片、一个表格和三篇参考文献的.docx文件。关键是文档中尽量使用 Word 的内置样式比如“标题 1”“标题 2”而不是手动加粗放大这样 Codex 才能识别出结构。如果没有现成文档可以让 Codex 先帮助生成codex 生成一个简单的 docx 测试论文包含标题、摘要、两个一级标题、一张图片、一个三列表格和三条参考文献这种测试文档不需要内容真实只要结构完整即可。4.2 查看 docx 内部结构.docx本质上是一个 ZIP 压缩包。先看它包含哪些文件unzip -l paper.docx输出中重点观察word/document.xml和word/media/。前者是正文内容后者是图片资源。继续查看正文里的样式unzip -p paper.docx word/document.xml | grep -o w:pStyle w:val[^]* | sort | uniq -c这个命令会统计文档中使用到的段落样式。如果看到Heading1、Heading2说明文档结构规范后续映射会很顺利如果全是Normal或正文则说明标题是靠手动格式控制的转换前需要先整理文档。4.3 导出图片把 Word 中的图片资源释放到独立目录mkdir -p images unzip -j paper.docx word/media/* -d images/ ls -l images/导出后Codex 在生成 LaTeX 时可以参照images目录里的文件写\includegraphics不需要再担心路径找不到。4.4 用 pandoc 生成基础草稿先让 pandoc 做第一层转换pandoc paper.docx -o paper-pandoc.tex --standalone生成的文件是可编译的但它是“一般 LaTeX 文档”不是“符合期刊模板的论文”。比如标题可能只是简单\title表格不会自动变成三线表参考文献也不会自动套用模板样式。这份草稿的价值是提供正文内容和基础结构最终交给 Codex 精调。4.5 调用 Skill 完成转换现在使用刚才创建的 Skill 执行完整转换codex 使用 docx-to-latex-paper skill 将 paper.docx 转换为 LaTeX 项目输出为 main.tex并编译验证Codex 会按SKILL.md中写的步骤执行读取 docx 结构、处理图片、转换表格、适配模板、编译。如果期刊模板已经放在同一个工作目录可以追加一句期刊模板在 template 目录下请参照 sample.tex 调整 documentclass 和宏包。这一步就是所谓的“一键”。实际操作中Codex 可能在转换后主动运行latexmk -xelatex main.tex遇到报错再回头修改循环到编译通过为止。4.6 生成后的项目结构一次成功转换后的目录大致如下paper-work/ ├── paper.docx ├── paper-pandoc.tex ├── main.tex ├── references.bib ├── images/ │ └── image1.png └── template/ ├── yourjournal.cls └── yourjournal.bstmain.tex是入口文件references.bib存放参考文献images存放从 Word 中导出的图片template存放期刊模板文件。这套结构已经接近一个规范的 LaTeX 投稿项目。main.tex的骨架大致如下\documentclass[twocolumn]{yourjournal} \usepackage{ctex} \usepackage{graphicx} \usepackage{booktabs} \usepackage{tabularx} \graphicspath{{images/}} \title{基于深度学习的论文标题示例} \author{张三} \date{} \begin{document} \maketitle \begin{abstract} 摘要内容本文提出一种示例方法…… \noindent\textbf{关键词}示例LaTeXCodex \end{abstract} \section{引言} 这是引言段落。 \section{方法} \subsection{方法一} 方法一的内容。 \subsection{方法二} 方法二的内容。 \begin{figure}[htbp] \centering \includegraphics[width0.8\linewidth]{image1} \caption{示例图片} \label{fig:example} \end{figure} \section{结果} \begin{table}[htbp] \centering \begin{tabularx}{\textwidth}{l c c} \toprule 方法 准确率 备注 \\ \midrule 方法一 0.91 基线 \\ 方法二 0.95 本文方法 \\ \bottomrule \end{tabularx} \caption{实验对比结果} \label{tab:compare} \end{table} \bibliographystyle{yourjournal} \bibliography{references} \end{document}references.bib的简单示例article{example2023, author {Zhang, San and Li, Si}, title {An Example Paper}, journal {Journal of Examples}, year {2023}, volume {1}, pages {1--10} }注意main.tex中的\documentclass[twocolumn]{yourjournal}不是万能写法具体类名和选项以模板提供的sample.tex为准。Codex 的职责是参照模板自动调整但模板里没有的内容它不应该凭空捏造。4.7 编译验证手动执行一次编译确认结果latexmk -xelatex -synctex1 -interactionnonstopmode main.tex编译通过后至少检查以下内容检查项检查方式通过标准编译状态终端输出无 error只有少量 warning图片显示打开 PDF图片存在且位置合理表格显示查看 PDF表格未超出版心无竖线参考文献查看 PDF编号连续样式正确中文显示查看 PDF无方框、无乱码交叉引用查看 PDF图题、表题、章节引用无误如果编译报错不要立刻从头再转。先看错误信息中的文件行号定位是宏包缺失、表格溢出还是图片路径
用 Codex CLI 打造 Word 论文转 LaTeX 的自动化流水线
论文从 Word 转成 LaTeX是不少科研党都绕不过去的一道坎。手动复制粘贴一个小时只是基础操作公式、表格、图片换了环境要重新排版用在线工具转换完格式又跟期刊模板对不上。OpenAI 开源的 Codex CLI 提供了另一种做法让 AI 在本地读取文档、执行命令、反复编译再通过 Skill 机制把“Word 论文转 LaTeX 并适配期刊模板”这套流程固化下来变成一条可重复执行的自动化流水线。下面从零演示如何准备环境、编写一个 docx-to-latex-paper Skill把一篇带标题、图片、表格和参考文献的 Word 论文转成可编译的 LaTeX 项目并说明如何适配常见期刊模板。这套流程适合正在准备投稿的科研人员、帮助他人排版的技术支持人员以及想用 Codex CLI 管理重复性格式转换任务的开发者。所谓“一键”不是第一次使用就完全不用配置而是把整套规则预置成 Skill 后后续每次只需要一句话触发。1. 先理清 Word 转 LaTeX 的难点和自动化思路1.1 手动转换为什么容易翻车Word 是可视化排版格式藏在段落属性和样式里LaTeX 是声明式排版结构、样式和内容完全分离。两者之间不是“复制粘贴再改改字体”的关系而是一次结构重建。手动转换时以下内容最容易消耗时间标题层级辨认Word 里用加粗、字号、编号手动控制的标题到了 LaTeX 必须还原成\section、\subsection等命令。公式格式MathType 公式、Word 自带公式编辑器、公式图片三种形态需要三种处理方式。表格结构Word 里常见的网格线、双线、合并单元格在 LaTeX 中通常要改成booktabs三线表列宽和对齐方式都需要重新定义。图片引用Word 中图片是嵌入的浮动对象导出 LaTeX 后图片文件、路径、编号和交叉引用都要重建。参考文献手动排序的引用列表要转成.bib文件再让 BibTeX 自动编号。特殊字符_ % # $ { }这些字符在 LaTeX 中有特殊含义不转义会导致编译失败。下面这张表可以快速看出一篇 Word 论文在转入 LaTeX 时要经历哪些变化。Word 中的常见状态转到 LaTeX 时要做的处理标题靠加粗和字号区分恢复为\section、\subsection等层级命令公式用 MathType 或公式编辑器转换为 LaTeX 数学语法编号方式统一表格使用网格线和双线改为booktabs三线表重设列宽与对齐图片是居中嵌入的浮动对象使用figure环境并设置\caption、\label引用手动编号使用 BibTeX 或 biblatex 自动编号章节交叉引用写“见图1”使用\ref、\autoref自动更新引用如果论文只有几千字、没有公式手动转换还能接受。一旦进入多图、多表、多公式的真实投稿场景手动方案不仅效率低还容易出现“正文改完了图表编号忘了更新”这类低级错误。1.2 为什么 Codex 适合做这个转换Codex CLI 是 OpenAI 开源的命令行 AI 助手它能在终端中读取文件、写文件、执行 shell 命令并且根据运行结果继续调整自己的操作。这正好匹配“Word 转 LaTeX”这类多步骤任务先解析文档结构再生成.tex接着编译看到报错后修改最后输出可用的 PDF。Codex 的 Skill 机制解决的是“复用”问题。没有 Skill 时每次都要在对话里重新描述转换规则、模板要求、检查标准有了 Skill这些内容被固化到本地目录中的SKILL.md和参考资料里。用户只需要写一句“使用某个 Skill 处理某个文件”Codex 就会按预置流程执行。这个过程的价值不只是省掉一条长提示词规则可维护期刊模板调整时只改 Skill 中的参考文件即可。团队可共享把 Skill 目录放入 Git 仓库成员克隆后就能使用同一套转换标准。结果可复现同一份文档在不同时间转换执行逻辑一致不会因为一次对话状态不同而飘忽。本地执行未发表的论文稿件不需要上传到第三方在线转换服务降低隐私顾虑。1.3 这套方案的边界必须承认不是所有 Word 文档都能被自动转换成 100% 还原的 LaTeX。以下场景需要人工介入公式密集且混用了 MathType、OMML、图片三种形式的文档含有大量合并单元格、复杂嵌套表格的文档模板本身不规范缺少样例.tex和宏包的期刊Word 中完全通过手动空格对齐的“伪表格”。所以把 Codex 定位成“自动完成 80% 重复劳动剩下 20% 由人核对”是最稳妥的使用心态。下面进入环境准备。2. 环境准备Codex CLI、LaTeX 发行版与 pandoc2.1 安装 Codex CLICodex CLI 的安装方式在不同版本之间有差异常见途径有两种。如果官方提供 npm 包可以执行npm install -g openai/codex如果更习惯直接使用发行版二进制可以从 GitHub Releases 页面下载当前系统对应的压缩包解压后把可执行文件加入PATH。也可以克隆官方仓库后按 README 说明从源码构建。具体方式以官方 README 为准不要照搬一个固定的安装命令到所有系统。安装后先验证版本codex --version首次启动时根据提示完成账号登录或 API Key 配置。不同版本的鉴权方式有差异直接跟随终端提示即可。配置完成后可以执行一条简单命令测试codex 列出当前目录下的文件如果 Codex 能正确读取目录并描述文件说明基础功能可用。2.2 安装 LaTeX 发行版LaTeX 编译器是整个流水线的终点建议按操作系统选择发行版。操作系统推荐发行版说明WindowsTeX Live 或 MiKTeXTeX Live 宏包完整安装时间长MiKTeX 按需安装宏包占用小macOSMacTeX官方 GUI 安装包内含 TeX Live、TeXShop 等工具Linuxtexlive-full多数发行版可通过包管理器安装宏包齐全跨平台Overleaf在线编译适合协作但不适合需要本地执行的自动化流程安装完后验证两个关键命令xelatex --version latexmk --version这里特意使用xelatex而不是pdflatex因为中文学术论文场景下xelatex配合ctex宏包对中文的支持最省心。后面示例也统一用latexmk -xelatex作为编译命令。2.3 安装 pandoc 作为转换过渡工具pandoc 是文档格式转换的瑞士军刀。完整方案不是让 Codex 从零读取二进制.docx文件而是先用 pandoc 把.docx转成一份基础.tex草稿再让 Codex 在此基础上做语义调整、模板适配和编译修复。安装 pandocpandoc --versionmacOS 可以使用brew install pandocLinux 使用系统包管理器安装pandocWindows 使用安装包或包管理器。pandoc 版本之间差异不大但转换效果可能受版本影响建议保持最新稳定版。2.4 配置 VS Code 和 LaTeX Workshop推荐使用 VS Code 加 LaTeX Workshop 扩展进行后续编辑。安装扩展后在settings.json里配置一套 xelatex 编译链{ latex-workshop.latex.recipes: [ { name: latexmk (xelatex), tools: [ latexmk (xelatex) ] } ], latex-workshop.latex.tools: [ { name: latexmk (xelatex), command: latexmk, args: [ -xelatex, -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] } ] }配置完成后在 VS Code 中打开.tex文件点右上角 TeX 图标即可启动编译。这个配置里的-file-line-error很重要错误信息会精确到文件行号后面排查问题时能省很多时间。到这里环境中的三根支柱已经就绪Codex 负责调用 AI 能力和执行命令行pandoc 负责基础转换LaTeX 环境负责编译和报错。可以先做一个总检查codex --version xelatex --version pandoc --version latexmk --version四个命令都没有报错再进入 Skill 编写阶段。3. 编写一个可复用的 docx-to-latex-paper Skill3.1 没有 Skill 时转换流程有多难重复如果直接在 Codex 对话里手动描述规则每次要写的信息非常长Word 文件在哪里、图片怎么处理、表格要不要转三线表、参考文献用哪个样式、编译命令是什么、报错后怎么办。这些内容写一遍就够繁琐更不用说每次换文档都要重写一遍。Skill 的本质就是把这些指令和领域知识放到固定目录中让 Codex 在用户触发时自动读取。你只需要在对话里说“使用 docx-to-latex-paper 处理 paper.docx”剩下的规则全部由 Skill 提供。3.2 建立 Skill 目录Codex 的 Skill 通常放在用户目录的.codex/skills下常见结构如下~/.codex/skills/docx-to-latex-paper/ ├── SKILL.md └── references/ ├── conversion-rules.md └── template-checklist.md不同版本的 Codex 对 Skill 的识别位置可能有差异如果~/.codex/skills不存在先查看当前版本官方文档确认目录。也可以用一条命令创建目录mkdir -p ~/.codex/skills/docx-to-latex-paper/references3.3 编写 SKILL.md 主文件SKILL.md是 Skill 的入口包含元信息、适用场景、执行步骤和结果标准。下面是适合作为起点的一个版本--- name: docx-to-latex-paper description: 将 Word 论文转换为 LaTeX 源码并适配指定期刊模板。 --- # Word 论文转 LaTeX ## 适用场景 - 输入.docx 格式的论文稿件 - 输出可编译的 LaTeX 项目目录 - 目标符合指定期刊模板的排版要求 ## 转换前检查 1. 确认 .docx 文件存在且可正常打开。 2. 确认 pandoc、xelatex、latexmk 已安装。 3. 确认期刊模板目录存在包含 .cls 或 .bst 文件。 ## 执行步骤 1. 使用 pandoc 将 .docx 转换为基础 .tex 草稿。 2. 解压 .docx 检查 word/document.xml 中的标题样式。 3. 将 Word 内置样式映射为 LaTeX 章节命令。 4. 导出 docx 内置图片到 images 目录并修正路径。 5. 将表格转换为 booktabs 三线表必要时使用 tabularx。 6. 检查公式语法统一使用 equation 或 align 环境。 7. 应用期刊模板替换 documentclass 和相关宏包。 8. 使用 latexmk -xelatex 编译修复所有 error。 ## 结果标准 - 编译无 error。 - 图片、表格编号连续交叉引用正确。 - 参考文献格式与期刊模板一致。 - PDF 中文字体正常显示无方框乱码。description字段是 Codex 判断何时使用该 Skill 的关键要写得像一条普通功能描述而不是内部代号。执行步骤中的每一步都应当让 Codex 在转换时真正执行而不是只读一遍。3.4 编写转换规则参考文件references/conversion-rules.md用来存放具体的格式规则。主文件负责流程参考文件负责细节这样后续修改规则时不需要改动主逻辑。# LaTeX 转换规则 ## 标题映射 - Word 样式 Heading 1 - \section{} - Word 样式 Heading 2 - \subsection{} - Word 样式 Heading 3 - \subsubsection{} ## 表格 - 优先使用 booktabs避免竖线。 - 列宽超出 \textwidth 时使用 tabularx。 - 单元格内容含特殊字符时做转义。 - Word 中常见的表格双线统一改成三线表结构。 ## 图片 - 将所有图片复制到 images/ 目录。 - 使用 \includegraphics 时省略扩展名。 - 主文件设置 \graphicspath{{images/}}。 - 图片必须使用 figure 环境并补全 \caption 和 \label。 ## 公式 - 独立公式使用 equation 环境需要多行时使用 align。 - 行内公式使用 \( ... \)避免使用 $$ ... $$。 - MathType 公式需要先转换成 LaTeX 语法无法直接读取时询问用户。 ## 特殊字符 - _ % # $ { } 在普通文本中需要转义。 - 反斜杠本身用于命令不要直接复制 Windows 路径到 LaTeX 中。这个文件解决了大多数转换“半成品”的问题。比如 Word 表格经常是网格线加重复表头转换后容易出现竖线过多、列宽失衡规则中直接写“避免竖线、用三线表”Codex 执行时就有了明确依据。3.5 编写模板检查清单参考文件references/template-checklist.md用于保存期刊模板相关的核对项# 期刊模板适配检查清单 ## 文档类 - [ ] documentclass 是否替换为模板提供的类名 - [ ] 是否需要 twocolumn、manuscript 等选项 - [ ] 模板提供的 .sty 是否已全部加载 ## 标题与作者 - [ ] 标题是否使用模板提供的 title 命令或环境 - [ ] 作者、单位、邮箱是否填写正确 ## 摘要与关键词 - [ ] 是否使用 abstract 环境 - [ ] 关键词格式是否与模板一致 ## 章节与图表 - [ ] 章节标题是否按模板格式显示 - [ ] 图表标题编号是否连续 - [ ] 表格是否使用三线表样式 ## 参考文献 - [ ] bibliographystyle 是否使用模板提供的 .bst - [ ] BibTeX 是否能无警告编译 ## 中文支持 - [ ] 使用 xelatex 编译 - [ ] 是否加载 ctex 宏包这些检查项不是给读者看的而是写给 Codex 的指令。Skill 执行完转换后Codex 会逐项核对并报告未通过项。3.6 验证 Skill 是否被识别在 Codex 交互界面中先确认 Skill 被加载codex然后在对话里输入列出当前可用的 skill如果 Skill 创建成功列表中应该能看到docx-to-latex-paper。看不到时先检查目录名是否为skills、SKILL.md文件名大小写是否正确再查看官方文档确认存放位置。值得注意的是Skill 文件修改后可能需要重启 Codex 进程才能生效。如果发现修改不生效先重启再测试。4. 实测把一篇带图表的 Word 论文转换成 LaTeX4.1 准备一份测试 Word 文档为了验证整个流程先准备一个测试目录和示例文档mkdir -p paper-work cd paper-work测试文档不必用真实论文可以构造一个包含标题、摘要、两个章节、一张图片、一个表格和三篇参考文献的.docx文件。关键是文档中尽量使用 Word 的内置样式比如“标题 1”“标题 2”而不是手动加粗放大这样 Codex 才能识别出结构。如果没有现成文档可以让 Codex 先帮助生成codex 生成一个简单的 docx 测试论文包含标题、摘要、两个一级标题、一张图片、一个三列表格和三条参考文献这种测试文档不需要内容真实只要结构完整即可。4.2 查看 docx 内部结构.docx本质上是一个 ZIP 压缩包。先看它包含哪些文件unzip -l paper.docx输出中重点观察word/document.xml和word/media/。前者是正文内容后者是图片资源。继续查看正文里的样式unzip -p paper.docx word/document.xml | grep -o w:pStyle w:val[^]* | sort | uniq -c这个命令会统计文档中使用到的段落样式。如果看到Heading1、Heading2说明文档结构规范后续映射会很顺利如果全是Normal或正文则说明标题是靠手动格式控制的转换前需要先整理文档。4.3 导出图片把 Word 中的图片资源释放到独立目录mkdir -p images unzip -j paper.docx word/media/* -d images/ ls -l images/导出后Codex 在生成 LaTeX 时可以参照images目录里的文件写\includegraphics不需要再担心路径找不到。4.4 用 pandoc 生成基础草稿先让 pandoc 做第一层转换pandoc paper.docx -o paper-pandoc.tex --standalone生成的文件是可编译的但它是“一般 LaTeX 文档”不是“符合期刊模板的论文”。比如标题可能只是简单\title表格不会自动变成三线表参考文献也不会自动套用模板样式。这份草稿的价值是提供正文内容和基础结构最终交给 Codex 精调。4.5 调用 Skill 完成转换现在使用刚才创建的 Skill 执行完整转换codex 使用 docx-to-latex-paper skill 将 paper.docx 转换为 LaTeX 项目输出为 main.tex并编译验证Codex 会按SKILL.md中写的步骤执行读取 docx 结构、处理图片、转换表格、适配模板、编译。如果期刊模板已经放在同一个工作目录可以追加一句期刊模板在 template 目录下请参照 sample.tex 调整 documentclass 和宏包。这一步就是所谓的“一键”。实际操作中Codex 可能在转换后主动运行latexmk -xelatex main.tex遇到报错再回头修改循环到编译通过为止。4.6 生成后的项目结构一次成功转换后的目录大致如下paper-work/ ├── paper.docx ├── paper-pandoc.tex ├── main.tex ├── references.bib ├── images/ │ └── image1.png └── template/ ├── yourjournal.cls └── yourjournal.bstmain.tex是入口文件references.bib存放参考文献images存放从 Word 中导出的图片template存放期刊模板文件。这套结构已经接近一个规范的 LaTeX 投稿项目。main.tex的骨架大致如下\documentclass[twocolumn]{yourjournal} \usepackage{ctex} \usepackage{graphicx} \usepackage{booktabs} \usepackage{tabularx} \graphicspath{{images/}} \title{基于深度学习的论文标题示例} \author{张三} \date{} \begin{document} \maketitle \begin{abstract} 摘要内容本文提出一种示例方法…… \noindent\textbf{关键词}示例LaTeXCodex \end{abstract} \section{引言} 这是引言段落。 \section{方法} \subsection{方法一} 方法一的内容。 \subsection{方法二} 方法二的内容。 \begin{figure}[htbp] \centering \includegraphics[width0.8\linewidth]{image1} \caption{示例图片} \label{fig:example} \end{figure} \section{结果} \begin{table}[htbp] \centering \begin{tabularx}{\textwidth}{l c c} \toprule 方法 准确率 备注 \\ \midrule 方法一 0.91 基线 \\ 方法二 0.95 本文方法 \\ \bottomrule \end{tabularx} \caption{实验对比结果} \label{tab:compare} \end{table} \bibliographystyle{yourjournal} \bibliography{references} \end{document}references.bib的简单示例article{example2023, author {Zhang, San and Li, Si}, title {An Example Paper}, journal {Journal of Examples}, year {2023}, volume {1}, pages {1--10} }注意main.tex中的\documentclass[twocolumn]{yourjournal}不是万能写法具体类名和选项以模板提供的sample.tex为准。Codex 的职责是参照模板自动调整但模板里没有的内容它不应该凭空捏造。4.7 编译验证手动执行一次编译确认结果latexmk -xelatex -synctex1 -interactionnonstopmode main.tex编译通过后至少检查以下内容检查项检查方式通过标准编译状态终端输出无 error只有少量 warning图片显示打开 PDF图片存在且位置合理表格显示查看 PDF表格未超出版心无竖线参考文献查看 PDF编号连续样式正确中文显示查看 PDF无方框、无乱码交叉引用查看 PDF图题、表题、章节引用无误如果编译报错不要立刻从头再转。先看错误信息中的文件行号定位是宏包缺失、表格溢出还是图片路径