LaTeX

核心用法

本 skill 提供 LaTeX 文档编写的系统性指导，涵盖从基础语法到高级排版的完整工作流。核心功能包括：

特殊字符与标点：明确区分保留字符的转义规则（\# \$ \% 等）、波浪号与抑扬符的正确用法（\textasciitilde/\textasciicircum），以及引号系统（` '' ）和三种横线（-/--/---`）的语义差异。

数学模式：区分行内 $...$ 与显示 \[...\]/equation 环境，推荐 align 环境处理多行公式，强调 \left(...\right) 自动定界符的配对使用，以及数学内部文本的 \text{} 插入方法。

间距控制：涵盖命令后空格保护（{} 或 \ ）、非断行空格（~ 用于数值单位），以及数学模式下的四级间距命令（\, \: \; \quad \qquad）。

包管理与编译：关键原则包括加载顺序（hyperref 通常置末）、UTF-8 编码双保险（inputenc+fontenc）、专业表格推荐 booktabs 和 microtype 微排版优化。详细说明交叉引用需双编译、参考文献需四步编译链（latex→bibtex→latex→latex）。

浮动体与图表：[htbp] 选项的语义（建议而非命令）、[H] 强制固定、\centering 优于 center 环境；表格推荐三线表风格（\toprule/\midrule/\bottomrule），图片优先 PDF/EPS 矢量格式。

显著优点

• 权威准确：内容源自 TeX 社区最佳实践，如 hyperref 置末、microtype 早载等顺序规则，以及 booktabs 反对竖线的专业排版传统
• 细节完备：覆盖高频陷阱（\~ 是重音符而非波浪字符、\\ 是换行而非反斜杠、命令后空格吞噬问题）
• 工程实用：明确区分 \input 与 \include 的页断行为，提供 Overfull hbox 的三种修复策略

潜在局限

• 引擎特定：部分建议绑定 pdflatex/xelatex/lualatex 差异（如字体编码 T1 仅适用于传统 latex→dvips 链，现代引擎可能无需）
• 领域偏向：侧重科技论文排版，对 Beamer、TikZ、复杂多语言文档（CTeX 环境）覆盖有限
• 版本演进：inputenc 在 2018 年后 LaTeX 内核已默认 UTF-8，显式加载可能冗余

适合人群

学术论文作者、学位论文撰写者、期刊投稿者、需要生成高质量 PDF 的技术文档编写者。尤其适合已有 Markdown 或 Word 经验、希望迁移至专业排版系统的用户。

常规风险

• 编译链复杂性：新手常因未执行多遍编译导致引用缺失或目录异常
• 包冲突：hyperref 虽需置末，但与部分包仍存在已知冲突（如与 cleveref 的加载顺序）
• 路径与编码：跨平台协作时，Windows 路径分隔符与 Linux/macOS 差异、遗留 GBK 编码文档转换问题
• 浮体漂移：过度使用 [H] 可能破坏页面布局，需理解 LaTeX 浮动算法的设计哲学

核心用法

本 Skill 是一份完整的 LaTeX 编写规范参考文档，面向需要撰写学术论文、技术报告或书籍的用户。内容覆盖从基础转义字符到高级排版技巧的全流程指导，包括：特殊字符转义规则（如 $ extbackslash 等）、引号与破折号规范（`` ''、en-dash/em-dash 区分）、数学模式操作（行内/显示公式、多行对齐、自动定界符）、间距控制（细空格 \, 到 \qquad 的层级使用）、关键宏包加载顺序（hyperref 置末、microtype 前置）、浮动体管理（[htbp] 放置建议、[H] 强制定位）、交叉引用机制（需两次编译、
label 紧跟
caption）、表格最佳实践（booktabs 三线表、去除内边距的 @{} 语法）、图片插入规范（PDF/EPS 优先、相对路径设置），以及常见错误排查（overfull hbox、缺失 $`、未定义控制序列等）。

显著优点

权威性指导：内容源自 LaTeX 社区长期实践积累，涵盖 CTAN 官方推荐的宏包使用规范，如 amsmath 处理复杂数学公式、booktabs 替代传统竖线表格、microtype 微调字距提升可读性，具有技术公信力。

场景覆盖全面：从短篇 article 到长篇 book 的文档类选择、从 `
input 片段化引入到
include` 章节分离的结构化方案，满足不同规模项目需求。

避坑导向设计：专门设置 "Common Errors" 章节，针对新手高频问题（如混淆 \\ 与 \ntextbackslash、误用 center 环境替代 `
centering`）给出明确纠正，显著降低学习成本。

潜在缺点与局限性

纯静态文档：本 Skill 仅提供语法参考，无交互式编译验证功能，用户仍需本地配置 TeX Live/MiKTeX 环境并手动执行 latex → bibtex → latex → latex 的四遍编译流程，对纯云端用户不够友好。

版本依赖隐忧：部分宏包行为随发行版更新可能变化（如 inputenc 在 TeX Live 2018+ 后逐渐弱化），文档未标注版本适用范围，可能引发跨环境兼容疑问。

非视觉化输出：缺乏编译预览或错误高亮，用户无法直观确认代码效果，需配合 Overleaf、TeXstudio 等外部工具使用。

适合的目标群体

• 科研工作者：需要撰写符合期刊格式要求的数学、物理、计算机科学论文
• 高校师生：撰写学位论文、课程报告、幻灯片（beamer 基础可延伸）
• 技术写作者：编写 API 文档、技术白皮书、开源项目手册
• LaTeX 进阶学习者：已入门但需系统规范编码习惯的 intermediate 用户

使用风险

编译安全风险：Skill 本身无代码执行，但用户按指导编译 .tex 文件时，若文档内含 `
write18（ shellescape ）或恶意宏包，可能触发系统命令执行。建议始终禁用 --shell-escape` 编译外部来源文件。

性能考量：大型文档（数百页书籍）编译耗时显著，四次编译流程在低端设备上可能超过数分钟，建议配合 latexmk 自动化工具使用。

依赖管理：宏包版本冲突（如 hyperref 与特定模板不兼容）可能导致编译失败，需具备基础调试能力。