Markdown 技术文档翻译审校与交付

固定不能随翻译改变的内容

本流程面向开源维护者、技术写作者和 SaaS 文档团队，输入是一篇已批准的 Markdown 技术页面，不负责从代码或 PDF 重新写文档，也不自动发布网站。记录源版本、目标语言地区、资源文件、渲染器和基础路径。提交源文前移除真实凭据，并确认允许外部 AI 处理。

先提取链接清单，再单独记录代码块、行内标识、命令、数值和警告段落。提取结果不保证覆盖所有特殊语法。约定哪些链接保持共用，哪些改到目标语言页面；每项例外指定负责人，不能在翻译过程中悄悄改变 API 版本、命令参数或必做操作。

译文恢复后仍需人工逐段审校

混合语言使自动识别含糊时，明确指定源语言，并提供批准的源词到目标词术语表。翻译器保护识别到的代码和链接形式，再恢复到译文；这并不是覆盖所有 Markdown 方言的完整解析保证。相对目的地、引用定义、转义网址和特殊代码围栏需要直接检查。全文检查残留占位符、漏段和损坏标记。

用目标语言术语表检查不推荐变体、大小写及缩写问题。若开启上下文 AI 分析，确认实际执行还是失败后退回本地规则。两种模式都不证明语义正确。技术审校人应完整对照源文和译文，尤其核对否定词、准备条件、参数说明、表格单元格和警告。文本差异适合比较字面不应变化的内容，以及草稿到定稿修改；双语正文差异很大不是准确率指标。

链接对账必须结合实际标题 ID

逐项比较源文和译文的链接、图片目的地，不只比较数量。数量相同仍可能指向不同位置。记录批准的地区化地址，保留相对图片和跨页面路径上下文。静态检查能提示识别到的格式、引用和片段问题，但不访问网络，也按自己的规则推导标题。

最容易遗漏的是旧目录片段仍保留，标题却已翻译。保留字符串不会生成同名 ID。接收系统支持固定 ID 时使用约定方案，否则同步修改依赖标题的引用与目标。检查器也可能误报它不理解的自定义 ID，需要依据实际文档站处理重复标题、Unicode 标识和跨页锚点。预览只辅助结构检查，还要在目标环境点击目录和资源。外部网址必须有另行授权的可访问性检查证据，不能靠静态通过宣布可用。

交付可编辑源与有明确用途的审阅稿

只从批准的 Markdown 导出。浏览器审阅可选 HTML，便于携带的批准稿可选 PDF 汇编；二者不是必须串联的转换链。汇编器能将源文和译文排成不同章节，但不会自动做逐段双栏对齐，要保持文件顺序并标明版本。

打开实际交付文件检查长代码行、表格、图片和目标语言字形。预览、导出和最终文档站可能采用不同渲染规则。相对资源需按预期目录一起交付，或批准后修改路径；PDF 能阅读不证明网站导航正常。保存 Markdown、选定审阅稿、术语表、源版本、链接对账、未确认事项和人工批准，不把临时下载链接当存档。一般文档编写转到文档发布专题，更广泛的字形及无障碍审查分别由相关工作流承担。