LaTeX 快速参考

一张高密度速查卡:骨架、文本、数学、浮动体、引用、版面、引擎、TikZ、Beamer 与常见日志错误。

LaTeX 快速参考

把它放在编辑器手边,每一行都可以直接粘贴。想看更长的课程,请打开 Learn 中对应的主题。

跳转: 骨架 · 导言区 · 文本 · 章节 · 交叉引用 · 数学 · 表格 · 图片 · 引用 · 版面 · 引擎 · TikZ · Beamer · 定理 · 学科片段 · 编译 · 错误 · 宏包加载顺序

文档骨架

\documentclass[11pt,a4paper]{article} % or report, book, beamer
\usepackage[margin=1in]{geometry}
\usepackage{amsmath,amssymb,amsfonts}
\usepackage{graphicx,booktabs}
\usepackage{xcolor}
\usepackage[colorlinks=true,linkcolor=blue,citecolor=blue,urlcolor=blue]{hyperref}
% \usepackage[backend=biber,style=numeric]{biblatex}
% \addbibresource{refs.bib}
\title{Title}
\author{Your Name}
\date{\today}
\begin{document}
\maketitle
\begin{abstract} ... \end{abstract}
\tableofcontents
\section{Introduction}
...
% \bibliographystyle{plain}\bibliography{refs} % BibTeX
% \printbibliography % biblatex
\end{document}
文档类典型用途
article论文、笔记、作业
report带章节的较长报告
book图书/学位论文
beamer幻灯片
大学 .cls学位论文模板
文件作用
.tex源文件
.bib参考文献数据库
.cls / .sty文档类/宏包
.aux .log .toc自动生成;请勿手改

导言区常用写法

\usepackage[margin=1in]{geometry}
\usepackage{setspace}\onehalfspacing
\usepackage{fancyhdr}
\pagestyle{fancy}
\usepackage{siunitx} % units and numbers
\usepackage{cleveref} % after hyperref
\DeclareMathOperator*{\argmax}{arg\,max}
\newcommand{\vect}[1]{\boldsymbol{#1}}

hyperref 要晚加载。cleveref 要在 hyperref 之后加载。

文本与格式

需求写法
粗体/斜体/等宽\textbf{} \textit{} \texttt{}
强调(可嵌套)\emph{}
小型大写字母\textsc{}
下划线(少用)\underline{}
字号{\small } {\large } {\Large } {\footnotesize }
新段落空行
换行\\ 或 \newline
不间断空格~
水平间距\quad \qquad \hspace{1em}
垂直间距\vspace{1em} \bigskip
居中/右对齐center / flushright 环境
引用quote 或 quotation
脚注\footnote{...}
注释% rest of line

特殊字符转义(文本模式)

字符代码字符代码
%\%$\$
&\&#\#
_\_{ }\{ \}
~\textasciitilde^\textasciicircum
\\textbackslash

列表

\begin{itemize}
\item Bullet
\end{itemize}
\begin{enumerate}
\item Numbered
\end{enumerate}
\begin{description}
\item[Term] Definition
\end{description}

自定义标签:\item[(a)] ...

页码与分页

需求写法
样式\pagestyle{plain} / empty / fancy
仅此页\thispagestyle{empty}
罗马数字/阿拉伯数字\pagenumbering{roman} 然后换 arabic
新页\newpage \clearpage
软分页请求\pagebreak[3]
保持同页\nopagebreak

章节与结构

\part{...} % book
\chapter{...} % report/book
\section{...}
\subsection{...}
\subsubsection{...}
\paragraph{...}
\section*{Unnumbered}
\addcontentsline{toc}{section}{Unnumbered}
需求写法
目录\tableofcontents
图表目录\listoffigures \listoftables
摘要\begin{abstract}...\end{abstract}
附录\appendix 之后用 \section / \chapter
多文件\include{chapters/intro} 或 \input{...}
只起草一章\includeonly{chapters/methods}
\section{Methods}\label{sec:methods}
\begin{equation}\label{eq:main} E=mc^2 \end{equation}
\begin{figure}
...
\caption{Pipeline}\label{fig:pipe}
\end{figure}
See Section~\ref{sec:methods}, Eq.~\eqref{eq:main}, Figure~\ref{fig:pipe}.
% with cleveref:
% \cref{fig:pipe} \Cref{sec:methods}
\usepackage{hyperref}
\url{https://oleafly.com}
\href{https://oleafly.com}{Oleafly}
\hypersetup{pdftitle={My Paper}, pdfauthor={You}}

把 \label 放在 \caption 之后,编号才会正确。

数学模式

需求写法
行内$...$ 或 \( ... \)
展示式,无编号\[ ... \]
展示式,带编号equation + \label
多行对齐align / align*
多行居中gather / gather*
一个编号,多行equation + split
长式断行multline
省略某个编号\notag 或 \nonumber
引用\ref{eq:x} 或 \eqref{eq:x}
\begin{align}
a &= b + c \label{eq:a} \\
d &= e + f \notag
\end{align}

分式、根式、上下标

\frac{a}{b} \dfrac{a}{b} \tfrac{a}{b}
\sqrt{x} \sqrt[n]{x}
x_i x^{2n} x_{ij}^{2}
f' f'' \dot{x} \ddot{x}

希腊字母(数学模式)

\alpha \beta \gamma \delta \epsilon \varepsilon \zeta \eta
\theta \vartheta \iota \kappa \lambda \mu \nu \xi
\pi \varpi \rho \varrho \sigma \varsigma \tau \upsilon
\phi \varphi \chi \psi \omega
\Gamma \Delta \Theta \Lambda \Xi \Pi \Sigma \Upsilon \Phi \Psi \Omega

运算符、关系、集合、箭头

\pm \mp \cdot \times \div \ast \star \circ \bullet
\leq \geq \neq \approx \equiv \sim \simeq \propto \ll \gg
\in \notin \subset \subseteq \supset \supseteq \cup \cap \emptyset
\to \mapsto \Rightarrow \Leftrightarrow \uparrow \downarrow
\infty \partial \nabla \ell \forall \exists \neg \land \lor

重音与字体字母

\hat{x} \bar{x} \tilde{x} \vec{x} \dot{x} \ddot{x}
\widehat{xyz} \overline{ABC}
\mathbb{N Z Q R C} \mathcal{L} \mathfrak{g}
\mathrm{d}x \mathbf{A} \boldsymbol{\beta}

大运算符与微积分

\sum_{i=1}^n \prod_{i=1}^n \int_a^b \oint \iint
\lim_{x \to 0} \max_x \min_x \inf \sup
\frac{dy}{dx} \frac{\partial f}{\partial x}
\argmax_x % after \DeclareMathOperator*{\argmax}{arg\,max}

矩阵

\begin{pmatrix} a & b \\ c & d \end{pmatrix} % ( )
\begin{bmatrix} a & b \\ c & d \end{bmatrix} % [ ]
\begin{vmatrix} a & b \\ c & d \end{vmatrix} % | |
\begin{array}{r|cc} 1 & 2 & 3 \\ \hline 4 & 5 & 6 \end{array}

分段函数

f(x) =
\begin{cases}
x^2 & x \ge 0 \\
-x & x < 0
\end{cases}

定界符

\left( \frac{a}{b} \right)
\left\{ x : x > 0 \right\}
\langle v, w \rangle
\lvert x \rvert \lVert v \rVert

实时预览:公式工具。

表格

\usepackage{booktabs}
\begin{table}[htbp]
\centering
\caption{Results}\label{tab:res}
\begin{tabular}{lcc}
\toprule
Model & Acc & F1 \\
\midrule
Baseline & 0.81 & 0.79 \\
Ours & 0.87 & 0.86 \\
\bottomrule
\end{tabular}
\end{table}
需求写法
列对齐l c r p{3cm}
竖线(避免使用)`
跨列\multicolumn{2}{c}{...}
跨行\multirow{2}{*}{...}(multirow)
跨页longtable
可视化构建器表格生成器

设计习惯:三条横线,不用竖线。

图片与浮动体

\usepackage{graphicx}
\begin{figure}[htbp]
\centering
\includegraphics[width=0.8\textwidth]{figures/plot.pdf}
\caption{Overview.}\label{fig:plot}
\end{figure}
需求写法
宽度width=0.5\textwidth 或 width=\linewidth
高度height=4cm(除非必要,避免两者都指定)
PDF 的某一页page=2 选项
并排两个 minipage,宽度为 0.48\textwidth
子图subcaption 宏包
放置位置[htbp](此处、页顶、页底、独立页)
浮动体屏障\usepackage{placeins} + \FloatBarrier

引用与参考文献

BibTeX(经典)

See \cite{knuth84} and \cite{a,b}.
\bibliographystyle{plain} % abbrv, alpha, ieeetr, apalike, ...
\bibliography{refs}

biblatex + biber

\usepackage[backend=biber,style=numeric]{biblatex}
\addbibresource{refs.bib}
...
\cite{knuth84} \parencite{knuth84} \textcite{knuth84}
\printbibliography

natbib

\usepackage{natbib}
\citet{key} % Author (year)
\citep{key} % (Author, year)
\citep*{key} % Author, year

最小的 .bib 条目

@article{knuth84,
author = {Knuth, Donald E.},
title = {Literate Programming},
journal = {The Computer Journal},
year = {1984},
volume = {27},
pages = {97--111}
}

校验:BibTeX 验证器。

症状解决办法
[?] 或 ?键名错误、缺少编译轮次,或 BibTeX 与 Biber 不匹配
参考文献为空路径、后端问题,或没有 \cite / 打印命令写错

版面

\usepackage[a4paper,margin=1in]{geometry}
\usepackage{setspace}\onehalfspacing
\setlength{\parindent}{0pt}
\setlength{\parskip}{0.6em}
需求写法
单处取消缩进\noindent
手动间距\hspace{2em} \vspace{1ex}
单位pt em ex cm mm in \textwidth \linewidth

引擎与宏包

引擎适用场景
pdfLaTeX期刊兼容性最高
XeLaTeX系统字体、多种文字(fontspec)
LuaLaTeX现代 Unicode + 脚本化
Tectonic内置/按需获取宏包(Oleafly 默认)
% Xe/Lua
\usepackage{fontspec}
\setmainfont{Times New Roman}

缺少宏包(TeX Live):tlmgr install siunitx

颜色

\usepackage{xcolor}
\textcolor{red}{warn}
\textcolor[HTML]{2563EB}{brand}
\definecolor{brand}{HTML}{2563EB}
\colorbox{gray!12}{highlight}

TikZ(最小示例)

\usepackage{tikz}
\usetikzlibrary{positioning,arrows.meta}
\begin{tikzpicture}[node distance=1.4cm]
\node[draw,rounded corners] (a) {In};
\node[draw,rounded corners,right=of a] (b) {Out};
\draw[-Latex] (a) -- (b);
\end{tikzpicture}

交换图:tikz-cd。独立导出:\documentclass[tikz]{standalone}。

Beamer(最小示例)

\documentclass{beamer}
\usetheme{Madrid}
\title{Talk}\author{You}
\begin{document}
\frame{\titlepage}
\begin{frame}{Results}
\begin{itemize}
\item<1-> First
\item<2-> Second
\end{itemize}
\pause
\end{frame}
\end{document}

定理

\usepackage{amsthm}
\newtheorem{theorem}{Theorem}[section]
\newtheorem{lemma}[theorem]{Lemma}
\begin{theorem}[Name]
Statement.
\end{theorem}
\begin{proof}
...
\end{proof}

学科小片段

% Chemistry
\usepackage[version=4]{mhchem}
\ce{H2O} \ce{CO2 + C -> 2CO}
% Physics
\usepackage{braket}
\braket{\psi|\phi} \braket{\psi|A|\phi}
% Code
\usepackage{listings}
\begin{lstlisting}[language=Python]
def f(x):
return x**2
\end{lstlisting}

编译循环

  1. 编辑 .tex
  2. 运行引擎(pdfLaTeX / XeLaTeX / LuaLaTeX / Tectonic)
  3. 如有引用:运行 BibTeX 或 Biber
  4. 再次运行引擎(通常两轮),直到 ?? 和目录稳定下来

在 Oleafly 中,编译(或自动编译)会完成整个循环;SyncTeX 在源码与 PDF 之间跳转。

日志错误(先解读第一条)

症状常见原因
文本在行中消失裸 % 开启了注释
Missing $ inserted文本中出现了 _、^ 或数学命令
Undefined control sequence拼写错误或缺少宏包
File not found输入文件或图片的路径/扩展名错误
引用印成 ??还需要再编译一轮
引用印成 [?]键名错误、后端不对,或缺少 BibTeX/Biber 轮次
参考文献为空\bibliography 路径错误或 biblatex 不匹配
Overfull \hbox内容无法断行(URL、长公式、无断字点)
Emergency stop缺少 \end{document}、include 出错、括号失控
Runaway argument缺少 } 或 \end{...}

宏包加载顺序(经验法则)

  1. 先写文档类选项
  2. 编码/字体
  3. 版面、行距、语言
  4. 数学、图形、表格
  5. 领域宏包
  6. hyperref 靠近末尾
  7. cleveref 在 hyperref 之后
主题入口
跑通流程第一个 PDF
公式功底数学模式 · 符号
浮动体表格 · 图片
引用添加引用
读懂日志未定义的控制序列
本地工作室Oleafly 工作流程
浏览器工具公式 · 表格 · BibTeX

完整目录:/learn/。

返回 案头参考