这是可以使用我们的多个免费在线工作站之一在 OnWorks 免费托管服务提供商中运行的命令 pandoc，例如 Ubuntu Online、Fedora Online、Windows 在线模拟器或 MAC OS 在线模拟器
程序：
您的姓名
pandoc - 通用标记转换器
概要
潘多克 [选项[输入文件] ...
商品描述
Pandoc 是一个 Haskell 库，用于从一种标记格式转换为另一种标记格式，以及
使用此库的命令行工具。 可以读取 Markdown、CommonMark、PHP Markdown
额外的、GitHub 风味的 Markdown 和（的子集）Textile、reStructuredText、HTML、LaTeX、
MediaWiki 标记、TWiki 标记、Haddock 标记、OPML、Emacs 组织模式、DocBook、txt2tags、
EPUB、ODT 和 Word docx； 并且可以写纯文本、Markdown、CommonMark、PHP Markdown
额外的、GitHub 风格的 Markdown、reStructuredText、XHTML、HTML5、LaTeX（包括 beamer
幻灯片）、ConTeXt、RTF、OPML、DocBook、OpenDocument、ODT、Word docx、GNU Texinfo，
MediaWiki 标记、DokuWiki 标记、Haddock 标记、EPUB（v2 或 v3）、FictionBook2、Textile、
groff 手册页、Emacs Org 模式、AsciiDoc、InDesign ICML 和 Slidy、Slideous、DZSlides，
reveal.js 或 S5 HTML 幻灯片放映。 它还可以在 LaTeX、
已安装 ConTeXt 或 wkhtmltopdf。
Pandoc 的 Markdown 增强版包括脚注、表格、灵活的语法
有序列表、定义列表、围栏代码块、上标和下标，
三振、元数据块、自动目录、嵌入式 LaTeX 数学、引文、
和 HTML 块元素内的 Markdown。 （这些增强功能，如下所述
Pandoc 的 Markdown，可以使用 markdown_strict 输入或输出格式禁用。）
与大多数使用正则表达式的将 Markdown 转换为 HTML 的现有工具相比
替换，pandoc 具有模块化设计：它由一组读取器组成，它们解析
给定格式的文本并生成文档的原生表示，以及一组
编写器，将本机表示转换为目标格式。 因此，添加一个
输入或输出格式只需要添加读取器或写入器。
因为 pandoc 对文档的中间表示不如许多
它之间转换的格式，人们不应该期望每个格式之间的完美转换
格式和其他格式。 Pandoc 试图保留一个的结构元素
文档，但不包括边距大小等格式细节。 还有一些文档元素，
例如复杂的表格，可能不适合 pandoc 的简单文档模型。 尽管
从 pandoc 的 Markdown 到所有格式的转换都渴望完美，从
预计比 pandoc 的 Markdown 更具表现力的格式是有损的。
运用 潘多克
如果不 输入文件 被指定，输入被读取 标准输入。 否则， 输入文件 旨在
连接（每个之间有一个空行）并用作输入。 输出转到 标准输出 by
默认（虽然输出到 标准输出 对 odt、docx、epub 和 epub3 输出禁用
格式）。 要输出到文件，请使用 -o 选项：
pandoc -o 输出.html 输入.txt
默认情况下，pandoc 生成一个文档片段，而不是一个具有适当
页眉和页脚。 要生成独立文档，请使用 -s 或 --standalone 标志：
pandoc -s -o 输出.html 输入.txt
有关如何生成独立文档的更多信息，请参阅下面的模板。
可以给出绝对 URI 代替文件。 在这种情况下 pandoc 将获取
使用 HTTP 的内容：
pandoc -f html -t 降价 http://www.fsf.org
如果给出多个输入文件，pandoc 将把它们全部连接起来（用空行
它们之间）在解析之前。 对于二进制输入格式禁用此功能，例如
EPUB、odt 和 docx。
可以使用命令行选项显式指定输入和输出的格式。
可以使用 -r/--read 或 -f/--from 选项指定输入格式，输出
使用 -w/--write 或 -t/--to 选项格式化。 因此，从 Markdown 转换 hello.txt
到 LaTeX，你可以输入：
pandoc -f markdown -t 乳胶你好.txt
要将 hello.html 从 HTML 转换为 Markdown：
pandoc -f html -t markdown hello.html
支持的输出格式在下面的 -t/--to 选项下列出。 支持的输入
下面在 -f/--from 选项下列出了格式。 请注意，首先，纺织品，乳胶，
和 html 阅读器不完整； 有一些构造它们不解析。
如果未明确指定输入或输出格式，pandoc 将尝试猜测它
来自输入和输出文件名的扩展名。 因此，例如，
pandoc -o hello.tex 你好.txt
将 hello.txt 从 Markdown 转换为 LaTeX。 如果没有指定输出文件（这样
输出到 标准输出)，或者如果输出文件的扩展名未知，则输出格式
将默认为 HTML。 如果没有指定输入文件（这样输入来自 标准输入）， 要么
如果输入文件的扩展名未知，则输入格式将被假定为
除非明确指定，否则降价。
Pandoc 对输入和输出都使用 UTF-8 字符编码。 如果你当地
字符编码不是 UTF-8，您应该通过 iconv 管道输入和输出：
iconv -t utf-8 输入.txt | 潘多克 | iconv -f utf-8
请注意，在某些输出格式（例如 HTML、LaTeX、ConTeXt、RTF、OPML、DocBook 和
Texinfo)，关于字符编码的信息包含在文档标题中，
仅当您使用 -s/--standalone 选项时才会包括在内。
创造 a PDF
要生成 PDF，请指定扩展名为 .pdf 的输出文件。 默认情况下，pandoc 将
使用 LaTeX 将其转换为 PDF：
pandoc test.txt -o test.pdf
生成 PDF 需要安装 LaTeX 引擎（请参阅下面的 --latex-engine），
并假设以下 LaTeX 包可用：amsfonts、amsmath、lm、
ifxetex、ifluatex、eurosym、listings（如果使用了 --listings 选项）、fancyvrb、
longtable、booktabs、graphicx 和 grffile（如果文档包含图像）、hyperref、
ulem、geometry（带有几何变量集）、setspace（带有 linestretch）和 babel
（与朗）。 使用 xelatex 或 lualatex 作为 LaTeX 引擎需要 fontspec；
xelatex 使用 mathspec、polyglossia（带有 lang）、xecjk 和 bidi（带有 dir 变量
放）。 如果可用，则使用 upquote 和 microtype 包，并且将使用 csquotes
如果添加到模板或包含在任何头文件中，则用于智能标点符号。 这
natbib、biblatex、bibtex 和 biber 包可以选择性地用于引用
渲染。 这些都包含在所有最新版本的 TeX Live 中。
或者，pandoc 可以使用 ConTeXt 或 wkhtmltopdf 创建 PDF。 为此，请指定
与以前一样具有 .pdf 扩展名的输出文件，但将 -t context 或 -t html5 添加到
命令行。
可以使用 LaTeX 的变量（如果使用 LaTeX）和变量来控制 PDF 输出
对于 ConTeXt（如果使用 ConTeXt）。 如果使用 wkhtmltopdf，则变量 margin-left，
margin-right、margin-top、margin-bottom 和 papersize 会影响输出，也一样
--css。
配置
常见问题 选项
-f FORMAT, -r FORMAT, --来自=FORMAT, --读=FORMAT
指定输入格式。 FORMAT 可以是原生的（原生 Haskell）、json（JSON 版本的
原生 AST）、markdown（pandoc 的扩展 Markdown）、markdown_strict（原始
未扩展的 Markdown), markdown_phpextra (PHP Markdown Extra), markdown_github
(GitHub-Flavored Markdown)、commonmark (CommonMark Markdown)、纺织 (Textile)、
rst (reStructuredText), html (HTML), 文档书 (DocBook), t2t (txt2tags), docx
(docx), odt (ODT), epub (EPUB), opml (OPML), org (Emacs Org 模式), mediawiki
（MediaWiki 标记）、twiki（TWiki 标记）、黑线鳕（Haddock 标记）或 Latex
（乳胶）。 如果将 +lhs 附加到 markdown、rst、latex 或 html，则输入将是
被视为读写 Haskell 源：请参阅下面的 Literate Haskell 支持。 降价
可以通过附加 +EXTENSION 单独启用或禁用语法扩展
或 -EXTENSION 格式名称。 所以，例如，
markdown_strict+footnotes+definition_lists 是带脚注的严格 Markdown 和
定义列表已启用，并且 markdown-pipe_tables+hard_line_breaks 是 pandoc 的
Markdown 没有管道表和硬换行符。 参见 Pandoc 的 Markdown，
下面是扩展名及其名称的列表。
-t FORMAT, -w FORMAT, --到=FORMAT, --写=FORMAT
指定输出格式。 FORMAT 可以是原生的（原生 Haskell），json（JSON 版本）
原生 AST）、plain（纯文本）、markdown（pandoc 的扩展 Markdown），
markdown_strict（原始未扩展的Markdown）、markdown_phpextra（PHP Markdown
Extra)、markdown_github (GitHub-Flavored Markdown)、commonmark (CommonMark
Markdown), rst (reStructuredText), html (XHTML), html5 (HTML5), Latex (LaTeX),
投影仪（LaTeX 投影仪幻灯片）、上下文 (ConTeXt)、男人 (groff man)、mediawiki
(MediaWiki markup)、dokuwiki (DokuWiki markup)、textile (Textile)、org (Emacs Org)
mode)、texinfo (GNU Texinfo)、opml (OPML)、docbook (DocBook)、opendocument
（OpenDocument）、odt（OpenOffice 文本文档）、docx（Word docx）、黑线鳕（Haddock
标记）、rtf（富文本格式）、epub（EPUB v2 书籍）、epub3（EPUB v3）、fb2
(FictionBook2 电子书), asciidoc (AsciiDoc), icml (InDesign ICML), slidy (Slidy HTML)
和 javascript 幻灯片），slideous（Slideous HTML 和 javascript 幻灯片），
dzslides (DZSlides HTML5 + javascript 幻灯片),revealjs (reveal.js HTML5 +
javascript 幻灯片）、s5（S5 HTML 和 javascript 幻灯片），或
自定义 lua 编写器（请参阅下面的自定义编写器）。 请注意，odt、epub 和 epub3
输出不会被定向到 标准输出; 必须使用指定输出文件名
-o/--output 选项。 如果将 +lhs 附加到 markdown、rst、latex、beamer、html，
或 html5，输出将呈现为有文字的 Haskell 源：请参阅文字
Haskell 支持，如下。 Markdown 语法扩展可以单独启用或
通过将 +EXTENSION 或 -EXTENSION 附加到格式名称来禁用，如所述
以上 -f 下。
-o 文件, --输出=文件
将输出写入 文件 而不是 标准输出。 如果 文件 是 -，输出将转到 标准输出.
（例外：如果输出格式是 odt、docx、epub 或 epub3，则输出到 stdout 是
禁用。）
--数据目录=目录
指定用户数据目录以搜索 pandoc 数据文件。 如果这个选项是
未指定，将使用默认用户数据目录。 这是，在 Unix 中：
$HOME/.pandoc
在 Windows XP 中：
C:\Documents And Settings\USERNAME\Application Data\pandoc
在 Windows Vista 或更高版本中：
C:\Users\用户名\AppData\Roaming\pandoc
您可以通过查看系统上的默认用户数据目录
pandoc --version 的输出。 一个reference.odt、reference.docx、epub.css、模板、
放置在此目录中的 slidy、slideous 或 s5 目录将覆盖 pandoc 的
正常默认。
--bash-完成
生成 bash 完成脚本。 要使用 pandoc 启用 bash 完成，请添加此
到您的 .bashrc：
eval "$(pandoc --bash-completion)"
--详细
给出详细的调试输出。 目前这只对 PDF 输出有影响。
-v， - 版
印刷版。
-H， - 帮帮我
显示使用消息。
读者 选项
-R, --解析原始
将不可翻译的 HTML 代码和 LaTeX 环境解析为原始 HTML 或 LaTeX，
而不是忽略它们。 仅影响 HTML 和 LaTeX 输入。 原始 HTML 可以是
打印在 Markdown、reStructuredText、HTML、Slidy、Slideous、DZSlides、reveal.js、
和S5输出； 原始 LaTeX 可以在 Markdown、reStructuredText、LaTeX 和
上下文输出。 默认是让读者省略不可翻译的 HTML 代码
和 LaTeX 环境。 （LaTeX 阅读器确实通过了不可翻译的 LaTeX
命令, 即使未指定 -R 。）
-S， - 聪明的
产生排版正确的输出，将直引号转换为弯引号，
--- 插入破折号， -- 插入破折号，以及 ... 省略号。 不间断空格是
在某些缩写后插入，例如“Mr.” （注：此选项被选中
当输出格式为 latex 或 context 时自动，除非 --no-tex-ligatures
用来。 它对乳胶输入没有影响。）
--旧破折号
选择 pandoc <= 1.8.2.1 解析智能破折号的行为： - 在数字之前
是一个破折号，而 -- 是一个长破折号。 此选项是自动选择的
纺织品输入。
--基本标头级别=NUMBER
指定标题的基本级别（默认为 1）。
--缩进代码类=课程设置
指定用于缩进代码块的类——例如，perl、numberLines 或
哈斯克尔。 多个类可以用空格或逗号分隔。
--默认图像扩展=延长
指定当图像路径/URL 没有扩展名时要使用的默认扩展名。 这个
允许您对需要不同类型的格式使用相同的源
图片。 目前这个选项只影响 Markdown 和 LaTeX 阅读器。
--过滤器=可执行
指定一个可执行文件用作过滤器，在之后转换 pandoc AST
输入被解析并在输出被写入之前。 可执行文件应读取 JSON
从标准输入并将 JSON 写入标准输出。 JSON 必须像 pandoc 自己的格式一样
JSON 输入和输出。 输出格式的名称将传递给过滤器
作为第一个论点。 因此，
pandoc --filter ./caps.py -t 乳胶
相当于
pandoc -t json | ./caps.py 乳胶 | pandoc -f json -t 乳胶
后一种形式可用于调试过滤器。
过滤器可以用任何语言编写。 Text.Pandoc.JSON 导出到 JSONFilter 到
方便在 Haskell 中编写过滤器。 那些更愿意在其中编写过滤器的人
python 可以使用可从 PyPI 安装的模块 pandocfilters。 还有
PHP、perl 和 javascript/node.js 中的 pandoc 过滤器库。
请注意 可执行 将在用户的 PATH 中寻找，而不是在工作中
目录，如果没有提供目录。 如果您想在工作中运行脚本
目录，在文件名前加上 ./.
-M KEY[=VAL], --元数据=KEY[:VAL]
设置元数据字段 KEY 到价值 VAL. 在命令行上指定的值
覆盖文档中指定的值。 值将被解析为 YAML 布尔值
或字符串值。 如果未指定值，则该值将被视为布尔值
真的。 与--variable 一样，--metadata 会导致设置模板变量。 但不像
--variable, --metadata 影响底层文档的元数据（即
可从过滤器访问，并可能以某些输出格式打印）。
--规范化
阅读后归一化文档：合并相邻的 Str 或 Emph 元素，对于
例如，并删除重复的空格。
-p, --保留选项卡
保留制表符而不是将它们转换为空格（默认）。 请注意，这
只会影响文字代码跨度和代码块中的选项卡； 常规文本中的选项卡
将被视为空格。
--制表符停止=NUMBER
指定每个制表符的空格数（默认为 4）。
--track-changes=接受|拒绝|全部
指定如何处理 MS Word“Track”产生的插入和删除
更改”功能。接受（默认），插入所有插入，并忽略所有
删除。 拒绝插入所有删除并忽略插入。 都放在两个
插入和删除，用插入和删除类包裹在跨度中，
分别。 包括作者和更改时间。 一切都对
脚本编写：仅接受来自某个审阅者的更改，例如，或在某个审阅者之前
日期。 此选项仅影响 docx 阅读器。
--提取媒体=DIR
将包含在 docx 或 epub 容器中的图像和其他媒体提取到路径
DIR，如有必要，创建它，并调整文档中的图像引用，以便
它们指向提取的文件。 此选项仅影响 docx 和 epub
读者。
常见问题 作家 选项
-是的， -独立
使用适当的页眉和页脚生成输出（例如独立的 HTML，
LaTeX 或 RTF 文件，而不是片段）。 此选项是为 pdf 自动设置的，
epub、epub3、fb2、docx 和 odt 输出。
--模板=文件
使用 文件 作为生成文档的自定义模板。 意味着--独立。
有关模板语法的说明，请参阅下面的模板。 如果没有扩展名
指定，将添加与作者对应的扩展名，以便
--template=special 为 HTML 输出寻找 special.html。 如果模板没有
找到了，pandoc会在用户数据的templates子目录中搜索
目录（见--data-dir）。 如果未使用此选项，则默认模板
将使用适合于输出格式（参见 -D/--print-default-template）。
-V KEY[=VAL], --变量=KEY[:VAL]
设置模板变量 KEY 到价值 VAL 在渲染文档时
独立模式。 这通常仅在使用 --template 选项时有用
指定自定义模板，因为 pandoc 会自动设置中使用的变量
默认模板。 如果不 VAL 指定，键将被赋予值
真实的。
-D FORMAT, --打印默认模板=FORMAT
打印输出的系统默认模板 FORMAT. （有关列表，请参阅 -t
可能 FORMATs.) 用户数据目录中的模板将被忽略。
--打印默认数据文件=文件
打印系统默认数据文件。 用户数据目录中的文件将被忽略。
--dpi=NUMBER
指定 dpi（每英寸点数）值以将像素转换为
英寸/厘米，反之亦然。 默认值为 96dpi。 从技术上讲，正确的
术语将是 ppi（每英寸像素数）。
--wrap=[自动|无|保留]
确定文本在输出中的包装方式（源代码，而不是呈现的
版本）。 使用自动（默认），pandoc 将尝试将行换行到列
由 --columns 指定的宽度（默认为 80）。 如果没有，pandoc 不会换行
根本。 使用保留，pandoc 将尝试保留包装
源文件（即，源文件中存在非语义换行符的地方，
输出中也将是非语义换行符）。
--无包装
--wrap=none 已弃用的同义词。
--列=NUMBER
以字符为单位指定行的长度（用于文本换行）。 这仅影响
生成的源代码，而不是呈现页面上的布局。
--目录， - 目录
包括一个自动生成的目录（或者，在乳胶的情况下，
上下文，第一个是在输出文档中创建一个）的指令。 这个
选项对 man、docbook、slidy、slideous、s5、docx 或 odt 输出没有影响。
--toc-深度=NUMBER
指定要包含在目录中的节级别数。 这
默认值为 3（这意味着级别 1、2 和 3 标题将列在
内容）。
--无高亮
禁用代码块和内联的语法高亮显示，即使是一种语言
属性给出。
--高亮风格=风格
指定要在突出显示的源代码中使用的着色样式。 选项是
pygments（默认）、kate、monochrome、espresso、zenburn、haddock 和 tango。
有关 pandoc 中语法突出显示的更多信息，请参阅语法突出显示，
联络一位教师
-H 文件, --包含在标题中=文件
包括内容 文件, 逐字逐句, 在标题的末尾。 这个可以用，
例如，在 HTML 文档中包含特殊的 CSS 或 javascript。 这个选项
可以重复使用以在标题中包含多个文件。 他们会
包含在指定的顺序中。 意味着--独立。
-B 文件, --include-before-body=文件
包括内容 文件, 逐字, 在文档正文的开头 (例如
之后HTML 中的标记，或 LaTeX 中的 \begin{document} 命令）。 这个可以
用于在 HTML 文档中包含导航栏或横幅。 这个选项可以
重复使用以包含多个文件。 它们将包含在订单中
指定的。 意味着--独立。
-A 文件, --include-after-body=文件
包括内容 文件，逐字逐句，在文档正文的末尾（在
HTML 中的标记，或 LaTeX 中的 \end{document} 命令）。 这个选项可以
重复使用以包含多个文件。 它们将包含在订单中
指定的。 意味着--独立。
附加选项 影响 具体的 作家
--自包含
使用 data: URI 生成一个没有外部依赖的独立 HTML 文件
合并链接脚本、样式表、图像和视频的内容。 这
生成的文件应该是“自包含的”，因为它不需要外部
文件，并且浏览器无法正确显示网络访问权限。 此选项有效
仅支持 HTML 输出格式，包括 html、html5、html+lhs、html5+lhs、s5、
slidy、slideous、dzslides 和revealjs。 脚本、图像和样式表位于
将下载绝对 URL； 相对 URL 中的那些将相对于
工作目录（如果第一个源文件是本地的）或相对于基础
URL（如果第一个源文件是远程的）。 限制：加载的资源
不能通过 JavaScript 动态合并； 其结果，
--self-contained 不适用于 --mathjax 和一些高级功能（例如
缩放或演讲者笔记）可能无法在离线“自包含”reveal.js 幻灯片中工作
显示。
--html-q-标签
在 HTML 中使用引号标记。
--ascii
在输出中仅使用 ascii 字符。 目前仅支持 HTML 输出
（选择此选项时使用数字实体而不是 UTF-8）。
--参考链接
在编写 Markdown 或
重构文本。 默认情况下使用内联链接。
--atx-标头
在 Markdown 和 asciidoc 输出中使用 ATX 样式的标头。 默认是使用
级别 1-2 的 setext 样式标头，然后是 ATX 标头。
--章节
将顶级标题视为 LaTeX、ConTeXt 和 DocBook 输出中的章节。 什么时候
LaTeX 文档类设置为 report、book 或 memoir，此选项是隐含的。
如果 beamer 是输出格式，顶级标题将变为 \part{..}。
-N, --数字部分
为 LaTeX、ConTeXt、HTML 或 EPUB 输出中的部分标题编号。 默认情况下，
部分没有编号。 类别未编号的部分将永远不会编号，
即使指定了 --number-sections 。
--数字偏移=NUMBER[,NUMBER,...]
HTML 输出中部分标题的偏移量（在其他输出格式中被忽略）。 这
第一个数字添加到顶级标题的部分编号，第二个用于
二级标题，等等。 因此，例如，如果您想要第一个顶级
文档中的标题编号为“6”，指定 --number-offset=5。 如果你的
文档以第 2 级标题开头，您希望将其编号为“1.5”，指定
--number-offset=1,4。 默认情况下，偏移量为 0。 暗示 --number-sections。
--no-tex-连字
不要将 TeX 连字用于引号、撇号和破折号 (`...',
``..'', --, ---) 写入或读取 LaTeX 或 ConTeXt 时。 在阅读 LaTeX 时，解析
字符 `、' 和 - 从字面上看，而不是解析连字以供引用
标记和破折号。 在编写 LaTeX 或 ConTeXt 时，打印 unicode 引号和
破折号字符，而不是将它们转换为标准的 ASCII TeX
连字。 注意：通常为 LaTeX 和 ConTeXt 自动选择 --smart
输出，但如果选择了 --no-tex-ligatures，则必须明确指定。 如果
您在源代码中使用文字卷曲引号、破折号和省略号，然后您可以
想在没有 --smart 的情况下使用 --no-tex-ligatures。
--列表
对 LaTeX 代码块使用列表包
-一世， - 增加的
使幻灯片中的列表项逐渐显示（一个接一个）。 默认是
用于一次性显示所有列表。
--幻灯片级别=NUMBER
指定具有指定级别的标题创建幻灯片（对于 beamer、s5、
滑动，滑动，dzslides）。 层次结构中此级别以上的标题用于
将幻灯片分成几个部分； 此级别以下的标题创建子标题
幻灯片内。 默认是根据内容设置幻灯片级别
文档; 请参阅构建幻灯片放映。
--section-div
将部分包裹在标签（或HTML5 中的标签），并将标识符附加到
封闭的（或者) 而不是标题本身。 见标题
标识符，如下。
--email-obfuscation=none|javascript|参考
指定一种混淆 mailto: HTML 文档中的链接的方法。 没有离开
mailto：链接原样。 javascript 使用 javascript 混淆它们。
引用通过将它们的字母打印为十进制或十六进制来混淆它们
字符参考。 默认为 javascript。
--id-前缀=STRING
指定要添加到 HTML 中所有自动生成的标识符的前缀和
DocBook 输出，以及 Markdown 输出中的脚注数字。 这对
在生成要包含在其他片段中的片段时防止重复标识符
页面。
-T STRING, --标题前缀=STRING
指定 STRING 作为出现在 HTML 中的标题开头的前缀
标题（但不在标题中，因为它出现在 HTML 正文的开头）。
意味着--独立。
-c 网址, --css=网址
链接到 CSS 样式表。 此选项可重复使用以包括
多个文件。 它们将包含在指定的顺序中。
--参考-odt=文件
使用指定的文件作为生成 ODT 的样式参考。 为获得最佳效果，
参考 ODT 应该是使用 pandoc 生成的 ODT 的修改版本。
引用 ODT 的内容被忽略，但它的样式表在
新的 ODT。 如果在命令行中没有指定引用 ODT，pandoc 将查找
用于用户数据目录中的文件 reference.odt（请参阅 --data-dir）。 如果这是
也没有找到，将使用合理的默认值。
--参考-docx=文件
使用指定的文件作为生成 docx 文件的样式参考。 最好的
结果，参考 docx 应该是生成的 docx 文件的修改版本
使用 pandoc。 参考 docx 的内容被忽略，但它的样式表
和文档属性（包括边距、页面大小、页眉和页脚）被使用
在新的 docx 中。 如果命令行没有指定引用docx，pandoc
将在用户数据目录中查找文件 reference.docx（请参阅 --data-dir）。
如果这也没有找到，则将使用合理的默认值。 以下款式
由 pandoc 使用：[段落] 正常、正文、第一段、紧凑、标题、
副标题、作者、日期、摘要、参考书目、标题 1、标题 2、标题 3、
标题 4、标题 5、标题 6、块文本、脚注文本、定义术语、
定义、标题、表格标题、图像标题、图、带标题的图、TOC
标题; [字符] 默认段落字体、正文字符、逐字字符、
脚注参考，超链接； 【表】普通表。
--epub-样式表=文件
使用指定的 CSS 文件来设置 EPUB 的样式。 如果没有指定样式表，
pandoc 将在用户数据目录中查找文件 epub.css（请参阅 --data-dir）。
如果在那里找不到，则将使用合理的默认值。
--epub-封面图片=文件
使用指定的图像作为 EPUB 封面。 建议图片为
宽度和高度小于 1000px。 请注意，在 Markdown 源文档中，您
还可以在 YAML 元数据块中指定封面图像（请参阅下面的 EPUB 元数据）。
--epub-元数据=文件
在指定的 XML 文件中查找 EPUB 的元数据。 该文件应包含
一系列都柏林核心元素。 例如：
创作共用
增强现实
默认情况下，pandoc 将包含以下元数据元素： （从
文件标题）， （来自文档作者）， （来自
文件日期，应采用 ISO 8601 格式）， （来自朗
变量，或者，如果未设置，则为语言环境），以及（一种
随机生成的 UUID）。 其中任何一个都可能被
元数据文件。
注意：如果源文档是 Markdown，文档中的一个 YAML 元数据块可以
改为使用。 请参阅下面的 EPUB 元数据。
--epub-嵌入字体=文件
在 EPUB 中嵌入指定的字体。 这个选项可以重复嵌入
多种字体。 也可以使用通配符：例如 DejaVuSans-*.ttf。
但是，如果您在命令行上使用通配符，请务必将它们转义或放置
单引号中的整个文件名，以防止它们被解释
贝壳。 要使用嵌入字体，您需要添加声明，如
遵循您的 CSS（请参阅 --epub-stylesheet）：
@字体脸{
字体系列：DejaVuSans；
字体样式：正常；
字体粗细：正常；
src:url("DejaVuSans-Regular.ttf");
}
@字体脸{
字体系列：DejaVuSans；
字体样式：正常；
字体重量：粗体;
src:url("DejaVuSans-Bold.ttf");
}
@字体脸{
字体系列：DejaVuSans；
字体样式：斜体；
字体粗细：正常；
src:url("DejaVuSans-Oblique.ttf");
}
@字体脸{
字体系列：DejaVuSans；
字体样式：斜体；
字体重量：粗体;
src:url("DejaVuSans-BoldOblique.ttf");
}
body { font-family: "DejaVuSans"; }
--epub-章节级别=NUMBER
指定将 EPUB 拆分为单独的“章节”文件的标头级别。
默认是在级别 1 标题处拆分为章节。 此选项仅影响
EPUB 的内部构成，而不是章节和章节的方式
显示给用户。 如果章节文件太大，一些读者可能会很慢，
因此，对于具有很少 1 级标题的大型文档，人们可能想要使用一章
2 或 3 级。
--latex-engine=pdflatex|lualatex|xelatex
生成 PDF 输出时使用指定的 LaTeX 引擎。 默认为 pdflatex。
如果引擎不在您的 PATH 中，则可以指定引擎的完整路径
点击此处。
--latex-engine-opt=STRING
使用给定的字符串作为 latex-engine 的命令行参数。 如果使用
多次，参数之间有空格。 请注意，没有
检查重复选项已完成。
引 翻译
--参考书目=文件
将文档元数据中的参考书目字段设置为 文件, 覆盖任何值
在元数据中设置，并使用 pandoc-citeproc 处理引文。 （这是
相当于 --metadata bibliography=FILE --filter pandoc-citeproc。）如果 --natbib
或 --biblatex 也提供， pandoc-citeproc 不使用，使其等效
到--元数据参考书目=文件。 如果您多次提供此参数，则每次
文件 将被添加到参考书目中。
--csl=文件
将文档元数据中的 csl 字段设置为 文件, 覆盖任何设置在
元数据。 （这等效于 --metadata csl=FILE。）此选项仅用于
与 pandoc-citeproc 相关。
--引文缩写=文件
将文档元数据中的 citation-abbreviations 字段设置为 文件, 覆盖
元数据中设置的任何值。 （这相当于
--metadata citation-abbreviations=FILE.) 此选项仅与
pandoc-citeproc。
--natbib
使用 natbib 在 LaTeX 输出中引用。 此选项不适用于
pandoc-citeproc 过滤器或带有 PDF 输出。 它旨在用于生产
可以用 bibtex 处理的 LaTeX 文件。
--biblatex
使用 biblatex 在 LaTeX 输出中引用。 此选项不适用于
pandoc-citeproc 过滤器或带有 PDF 输出。 它旨在用于生产
可以用 bibtex 或 biber 处理的 LaTeX 文件。
数学 翻译 in HTML
-m [网址], --latexmathml[=网址]
使用 LaTeXMathML 在 HTML 输出中显示嵌入的 TeX 数学。 这 网址 应该点
到 LaTeXMathML.js 加载脚本。 如果一个 网址 不提供，链接
将插入 LaTeXMathML 主页上的 LaTeXMathML.js。
--数学[=网址]
将 TeX 数学转换为 MathML（在 docbook 以及 html 和 html5 中）。 在独立
html 输出，一个小的 javascript（或者一个链接到这样的脚本，如果 网址 提供）
将被插入，允许在某些浏览器上查看 MathML。
--jsmath[=网址]
使用 jsMath 在 HTML 输出中显示嵌入的 TeX 数学。 这 网址 应该指向
jsMath 加载脚本（例如 jsMath/easy/load.js）； 如果提供，它将被链接
在独立 HTML 文档的标题中。 如果一个 网址 没有提供，没有链接
将插入 jsMath 加载脚本； 然后由作者提供
HTML 模板中的此类链接。
--mathjax[=网址]
使用 MathJax 在 HTML 输出中显示嵌入的 TeX 数学。 这 网址 应该指向
MathJax.js 加载脚本。 如果一个 网址 未提供，MathJax CDN 的链接
将被插入。
--格拉德克斯
将 TeX 数学包含在HTML 输出中的标签。 然后可以通过以下方式处理这些
gladTeX 生成排版公式图像的链接。
--mimetex[=网址]
使用 mimeTeX CGI 脚本渲染 TeX 数学。 如果 网址 没有指定，它是
假设脚本位于 /cgi-bin/mimetex.cgi。
--webtex[=网址]
使用将 TeX 公式转换为图像的外部脚本渲染 TeX 公式。
该公式将与提供的 URL 连接。 如果 网址 没有指定，
将使用 Google Chart API。
--katex[=网址]
使用 KaTeX 在 HTML 输出中显示嵌入的 TeX 数学。 这 网址 应该指向
katex.js 加载脚本。 如果一个 网址 未提供，将提供指向 KaTeX CDN 的链接
已插入。
--katex 样式表=网址
这款 网址 应该指向 katex.css 样式表。 如果未指定此选项，
将插入 KaTeX CDN 的链接。 请注意，此选项并不意味着
--katex。
附加选项 包装纸 脚本
--转储参数
将有关命令行参数的信息打印到 标准输出，然后退出。 这个选项
主要用于包装脚本。 第一行输出
包含使用 -o 选项指定的输出文件的名称，或 -（对于
标准输出) 如果没有指定输出文件。 其余行包含
命令行参数，每行一个，按照它们出现的顺序。 这些不
包括常规的 pandoc 选项及其参数，但要包括任何选项
出现在行尾的 -- 分隔符之后。
--忽略参数
忽略命令行参数（用于包装脚本）。 常规 pandoc 选项
不被忽视。 因此，例如，
pandoc --ignore-args -o foo.html -s foo.txt -- -e latin1
相当于
pandoc -o foo.html -s
TEMPLATES
当使用 -s/--standalone 选项时，pandoc 使用模板添加页眉和页脚
独立文件所需的材料。 查看默认模板
使用，只需输入
pandoc -D *格式*
哪里 FORMAT 是输出格式的名称。 可以使用指定自定义模板
--template 选项。 您还可以覆盖给定的系统默认模板
输出格式 FORMAT 通过在用户数据中放置一个文件模板/default.*FORMAT*
目录（参见上面的 --data-dir）。 例外： 对于 odt 输出，自定义
default.open 文档模板。 对于 pdf 输出，自定义 default.latex 模板。
模板包含 变量，允许在任何位置包含任意信息
指向文件。 可以使用 YAML 元数据块在文档中设置变量。
也可以使用 -V/--variable 选项在命令行中设置它们：变量设置在
这种方式覆盖具有相同名称的元数据字段。
变量 集 by 潘多克
pandoc 会自动设置一些变量。 这些有所不同，具体取决于
输出格式，但包括元数据字段以及以下内容：
标题， 作者， 日期
允许识别文件的基本方面。 包含在 PDF 元数据中
通过 LaTeX 和 ConTeXt。 这些可以通过 pandoc 标题栏设置，其中
允许多个作者，或通过 YAML 元数据块：
---
作者：
- 亚里士多德
- 彼得·阿伯拉德
...
字幕
文档副标题，包含在 HTML、EPUB、LaTeX、ConTeXt 和 Word docx 中； 渲染
在 LaTeX 中，仅当使用支持 \subtitle 的文档类时，例如 beamer
或 KOMA-Script 系列（scrartcl、scrreprt、scrbook）。
抽象
文档摘要，包含在 LaTeX、ConTeXt、AsciiDoc 和 Word docx 中
关键词
要包含在 HTML、PDF 和 AsciiDoc 元数据中的关键字列表； 或许
重复以上作者
标头包含
-H/--include-in-header 指定的内容（可能有多个值）
TOC 如果指定了 --toc/--table-of-contents，则为非空值
目录标题
目录标题（仅适用于 EPUB 和 docx）
包含在之前
-B/--include-before-body 指定的内容（可能有多个值）
包含在之后
-A/--include-after-body 指定的内容（可能有多个值）
身体 文件正文
元json
所有文档元数据的 JSON 表示
语言选择 变量
郎 使用符合 BCP 47 的代码标识文档的主要语言
（例如 en 或 en-GB）。 对于某些输出格式，pandoc 会将其转换为
适当的格式存储在附加变量 babel-lang, polyglossia-lang
(LaTeX) 和上下文语言 (ConTeXt)。
可以使用带有 lang 属性（BCP 47 中的值）的原生 pandoc spans 和 div
在该范围内切换语言。
其他语言
YAML 元数据中文档中使用的其他语言的列表，根据
BCP 47. 例如：otherlangs: [en-GB, fr]。 这是自动生成的
来自所有跨度和 div 中的 lang 属性，但可以覆盖。 目前
仅由 LaTeX 通过生成的 babel-otherlangs 和
polyglossia-otherlangs 变量。 LaTeX 编写器输出 polyglossia 命令
文本但 babel-newcommands 变量包含它们到
对应的巴别塔。
DIR 文档的基本方向，rtl（从右到左）或 ltr
（左到右）。
对于双向文档，原生 pandoc spans 和带有 dir 属性的 div
（值 rtl 或 ltr）可用于覆盖某些输出中的基本方向
格式。 如果最终渲染器（例如
浏览器，生成 HTML 时）支持 Unicode 双向算法。
使用 LaTeX 处理双向文档时，只有 xelatex 引擎完全
支持（使用 --latex-engine=xelatex）。
变量 幻灯片
变量可用于使用 pandoc 制作幻灯片，包括所有的reveal.js
配置选项。
滑动网址
Slidy 文档的基本 URL（默认为 http://www.w3.org/Talks/Tools/Slidy2)
滑动网址
Slideous 文档的基本 URL（默认为 Slideous）
s5-url S5 文档的基本 URL（默认为 s5/default）
揭示js-url
Reveal.js 文档的基本 URL（默认为reveal.js）
主题， 颜色主题， 字体主题， 内部主题， 外主题
LaTeX 投影仪文档的主题
导航
控制投影仪文档中的导航符号（默认为空，没有导航
符号； 其他有效值为框架、垂直和水平）。
章节标题
启用 Beamer 文档中新部分的“标题页”（默认值 = true）。
变量 胶乳
创建 PDF 时使用 LaTeX 变量。
纸型
纸张尺寸，例如信纸、A4
字体大小
正文的字体大小（例如 10pt、12pt）
文档类
文档类，例如文章、报告、书籍、回忆录
班级选择
文档类的选项，例如 oneside； 可以为多个选项重复
几何
几何包的选项，例如 margin=1in; 可以为多个选项重复
左边距， 边距右， 边距顶部， 底边
设置边距，如果不使用几何图形（否则几何图形会覆盖这些）
线条拉伸
使用 setspace 包调整行间距，例如 1.25, 1.5
字体系列
用于 pdflatex 的字体包：TeX Live 包括许多选项，记录在
LaTeX 字体目录。 默认为拉丁现代。
字体系列选项
用作 fontfamily 的包选项：例如 osf,sc，fontfamily 设置为
mathpazo 为 Palatino 提供了老式的数字和真正的小盘； 或许
重复多个选项
主字体， 无字体， 单字体， 数学字体， 中日韩字体
用于 xelatex 或 lualatex 的字体系列：取任何系统字体的名称，
使用 fontspec 包。 注意，如果使用 CJKmainfont，则 xecjk 包
必须可用。
主要字体选项， sansfontoptions， 单字体选项， 数学字体选项， 中日韩期权
在 xelatex 中与 mainfont、sansfont、monofont、mathfont、CJKmainfont 一起使用的选项
和 lualatex。 允许通过 fontspec 进行任何可用的选择，例如
OpenType 功能 Numbers=OldStyle，Numbers=Proportional。 可以重复
多种选择。
丰登
允许通过 fontenc 包（使用 pdflatex）指定字体编码；
默认为 T1（参见 LaTeX 字体编码指南）
颜色链接
为链接文本添加颜色； 如果有任何链接颜色、引用颜色、
设置了 urlcolor 或 toccolor
链接颜色， 引用颜色， 网址颜色， 托克色
内部链接、引文链接、外部链接和表格中的链接的颜色
内容：使用任何预定义的 LaTeX 颜色
链接即注释
导致链接被打印为脚注
缩进 使用文档类设置进行缩进（否则使用默认的 LaTeX 模板
删除缩进并在段落之间添加空格）
分段
禁用将（子）段落重新定义为的 LaTeX 模板的默认行为
部分，更改某些类中嵌套标题的外观
谢谢 在文档标题之后指定致谢脚注的内容。
TOC 包括目录（也可以使用 --toc/--table-of-contents 设置）
总深度
要包含在目录中的部分级别
洛夫， 很多
包括图表列表，表格列表
参考书目
用于解析引用的参考书目
书目式
参考书目风格，与 --natbib 和 --biblatex 一起使用时。
biblatex选项
biblatex 的选项列表。
变量 语境
纸型
纸张尺寸，例如 letter、A4、横向（请参阅 ConTeXt 纸张设置）； 可能会重复
对于多个选项
布局 页边距和文本排列的选项（请参阅 ConTeXt 布局）； 可能会重复
对于多个选项
左边距， 边距右， 边距顶部， 底边
设置边距，如果不使用布局（否则布局会覆盖这些）
字体大小
正文的字体大小（例如 10pt、12pt）
主字体， 无字体， 单字体， 数学字体
字体系列：取任何系统字体的名称（参见 ConTeXt 字体切换）
链接颜色， 对比色
页面内外链接的颜色，例如红色、蓝色（参见上下文颜色）
链接样式
链接的字体样式，例如正常、粗体、倾斜、粗体倾斜、类型、大写、
小
缩进
控制段落的缩进，例如 yes,small,next（参见 ConTeXt Indentation）；
可以为多个选项重复
空白
段落之间的间距，例如无，小（使用 setupwhitespace）
行间空间
调整行间距，例如 4ex（使用 setupinterlinespace）； 可以重复
多种选择
标题文本， 页脚文本
要放置在运行的页眉或页脚中的文本（请参阅 ConTeXt 页眉和页脚）；
不同位置最多可重复四次
页码
页码样式和位置（使用 setuppagenumbering）； 可以重复
多种选择
TOC 包括目录（也可以使用 --toc/--table-of-contents 设置）
洛夫， 很多
包括图表列表，表格列表
变量 男子 网页
部分
手册页中的节号
头 手册页中的标题
页脚 手册页中的页脚
调整
将文本调整到左边 (l)、右边 (r)、居中 (c) 或两者 (b) 边距
连字号
如果为 true（默认值），将使用连字符
运用 变量 in 模板
变量名称是由字母数字、- 和 _ 组成的序列，以字母开头。 一种
由 $ 符号包围的变量名称将被其值替换。 例如，
字符串 $title$ 输入
$title$
将被文档标题替换。
要在模板中写入文字 $，请使用 $$。
模板可能包含条件。 语法如下：
$if(变量)$
X
$其他$
Y
$结尾$
如果变量具有非空值，这将在模板中包含 X； 否则它会
包括 Y。X 和 Y 是任何有效模板文本的占位符，并且可能包括
内插变量或其他条件。 $else$ 部分可以省略。
当变量可以有多个值时（例如，在多作者文档中作者），
您可以使用 $for$ 关键字：
$for(作者)$
$结束$
您可以选择指定要在连续项目之间使用的分隔符：
$for(作者)$$author$$sep$, $endfor$
点可用于选择将对象作为其值的变量的字段。 所以，
例如：
$作者.姓名$ ($作者.隶属关系$)
如果您使用自定义模板，您可能需要在 pandoc 更改时修改它们。 我们推荐
跟踪默认模板中的更改，并修改您的自定义模板
因此。 一个简单的方法是 fork pandoc-templates 存储库并合并
在每次 pandoc 发布后的变化。
潘多克 降价
Pandoc 理解 John Gruber 的 Markdown 的扩展和稍微修改的版本
句法。 本文档解释了语法，并指出了与标准 Markdown 的区别。
除非另有说明，否则可以使用 markdown_strict 抑制这些差异
格式而不是降价。 可以通过添加 +EXTENSION 来启用扩展
格式名称并通过添加 -EXTENSION 禁用。 例如 markdown_strict+footnotes 就是
启用脚注的严格 Markdown，而 markdown-footnotes-pipe_tables 是 pandoc 的
没有脚注或管道表的 Markdown。
理念
Markdown 旨在易于编写，更重要的是，易于阅读：
Markdown 格式的文档应该可以按原样发布，作为纯文本，没有
看起来像是用标签或格式说明标记了。 - 约翰
格鲁伯
这一原则指导了 pandoc 为表格、脚注和
其他扩展。
然而，pandoc 的目标在某一方面与最初的目标不同
的降价。 而 Markdown 最初设计时就考虑到了 HTML 生成，
pandoc 专为多种输出格式而设计。 因此，虽然 pandoc 允许嵌入
原始 HTML，它不鼓励它，并提供其他非 HTMLish 的表示方式
重要的文档元素，如定义列表、表格、数学和脚注。
段
段落是一行或多行文本，后跟一个或多个空行。 换行符
被视为空格，因此您可以根据需要重排段落。 如果你需要一个硬
换行，在一行的末尾放置两个或多个空格。
扩展： 转义换行符
反斜杠后跟换行符也是硬换行符。 注意：在多行和网格中
表格单元格，这是创建硬换行符的唯一方法，因为在
单元格被忽略。
头
有两种报头：Settext 和 ATX。
文本样式 头
setext 样式的标题是一行“带下划线”的文本，带有一行 = 符号（对于级别
一个标题）或 - 符号（用于二级标题）：
一级标题
==================
二级标题
------------------
标题文本可以包含内联格式，例如强调（请参阅内联格式，
下文）。
ATX式 头
ATX 样式的标题由一到六个 # 符号和一行文本组成，可选地跟随
通过任意数量的# 符号。 行首#号的个数是
标题级别：
## 二级标题
### 三级标题###
与 setext 样式的标题一样，标题文本可以包含格式：
# 带有 [link](/url) 和 *emphasis* 的一级标题
扩展： 空白_before_header
标准 Markdown 语法不需要标题前的空行。 潘多克
需要这个（当然，在文档的开头除外）。 的原因
要求是 # 很容易出现在一行的开头
事故（可能是通过换行）。 考虑，例如：
我喜欢他们的几种口味的冰淇淋：
例如，#22 和 #5。
标题 身份标识
扩展： 标头属性
可以在包含
标题文本：
{#identifier .class .class 键=值键=值}
因此，例如，以下标头都将被分配标识符 foo：
# 我的标题 {#foo}
## 我的标题 ## {#foo}
我的另一个标题 {#foo}
---------------
（此语法与 PHP Markdown Extra 兼容。）
请注意，虽然此语法允许分配类和键/值属性，
作者通常不会使用所有这些信息。 标识符、类和键/值
属性用于 HTML 和基于 HTML 的格式，例如 EPUB 和 slidy。 身份标识
用于 LaTeX、ConTeXt、Textile 和 AsciiDoc 编写器中的标签和链接锚点。
类未编号的标题不会被编号，即使 --number-sections 是
指定的。 属性上下文中的单个连字符 (-) 等效于 .unnumbered，并且
最好是非英文文件。 所以，
# 我的标题 {-}
就是一样
# 我的标题 {.unnumbered}
扩展： 自动标识符
没有明确指定标识符的标头将自动分配一个
基于标题文本的唯一标识符。 从标头派生标识符
文字，
· 删除所有格式、链接等。
· 删除所有脚注。
· 删除所有标点符号，下划线、连字符和句点除外。
· 用连字符替换所有空格和换行符。
· 将所有字母字符转换为小写。
· 删除直到第一个字母的所有内容（标识符不能以数字或
标点符号）。
· 如果之后什么都没有，请使用标识符部分。
因此，例如，
标头标识符
────────────────────────────────────────────────────── ──────
HTML header-identifiers-in-html 中的标头标识符
*狗*？--在*我的*房子里？ 狗在我家
[HTML]、[S5] 还是 [RTF]？ html-s5-或-rtf
3. 应用应用
33部分
在大多数情况下，这些规则应该允许人们从标题中确定标识符
文本。 例外情况是多个标题具有相同的文本； 在这种情况下，第一个
将获得如上所述的标识符； 第二个将获得与 -1 相同的标识符
附加； 第三个是-2； 等等。
这些标识符用于在由生成的目录中提供链接目标
--toc|--table-of-contents 选项。 它们还可以轻松提供来自一个的链接
一个文件的一部分到另一个。 例如，此部分的链接可能看起来像
这个：
请参阅有关部分
[标题标识符](#header-identifiers-in-html-latex-and-context)。
但是请注意，这种提供部分链接的方法仅适用于 HTML、LaTeX、
和上下文格式。
如果指定了 --section-divs 选项，则每个部分都将包含在一个 div 中（或
一个部分，如果 --html5 被指定），并且标识符将附加到封闭的
（或者) 标签而不是标题本身。 这允许整个部分
使用 javascript 操作或在 CSS 中进行不同处理。
扩展： hidden_header_references
Pandoc 的行为就像为每个标题定义了参考链接。 所以，而不是
[标题标识符](#header-identifiers-in-html)
你可以简单地写
[头标识符]
or
[标题标识符][]
or
[关于标题标识符的部分][标题标识符]
如果有多个标题相同的文字，相应的参考将链接
仅指向第一个，您将需要使用显式链接来链接到其他链接，如
如上所述。
与常规参考链接一样，这些参考资料不区分大小写。
显式链接引用定义始终优先于隐式标头引用。
因此，在以下示例中，链接将指向 bar，而不是 #foo：
#福
[foo]: 酒吧
见 [foo]
阻止 报价
Markdown 使用电子邮件约定来引用文本块。 块引用是一个或
更多段落或其他块元素（例如列表或标题），每行
前面有一个 > 字符和一个可选的空格。 （> 不需要从左边开始
边距，但缩进不应超过三个空格。）
> 这是一个块引用。 这个
> 段落有两行。
>
> 1. 这是块引用内的列表。
> 2. 第二项。
一个“懒惰”的形式，它只需要在每个块的第一行的 > 字符，是
还允许：
> 这是一个块引用。 这个
段落有两行。
> 1. 这是块引用内的列表。
2. 第二项。
块引用中可以包含的块元素包括其他块引用。
也就是说，块引号可以嵌套：
> 这是一个块引用。
>
> > 块引用中的块引用。
如果 > 字符后跟一个可选空格，则该空格将被视为
块引用标记而不是内容缩进的一部分。 因此，把一个
块引用中的缩进代码块，在 > 后需要五个空格：
> 代码
扩展： 空白_before_blockquote
标准 Markdown 语法在块引用之前不需要空行。 潘多克
需要这个（当然，在文档的开头除外）。 的原因
要求是 > 很容易出现在一行的开头
事故（可能是通过换行）。 所以，除非使用 markdown_strict 格式，
以下不会在 pandoc 中产生嵌套块引用：
> 这是一个块引用。
>> 嵌套。
逐字 （代码） 块
缩进 码 块
缩进四个空格（或一个制表符）的文本块被视为逐字文本：即，
特殊字符不会触发特殊格式，所有空格和换行符都是
保存。 例如，
如果 (a > 3) {
移动船（5 * 重力，向下）；
}
初始（四个空格或一个制表符）缩进不被视为逐字逐字的一部分
文本，并在输出中删除。
注意：逐字文本中的空行不需要以四个空格开头。
围栏 码 块
扩展： 围栏代码块
除了标准的缩进代码块，pandoc 还支持 围栏 代码块。 这些
以一行三个或更多波浪号 (~) 开始，以一行必须位于的波浪号结束
至少与起始行一样长。 这些行之间的所有内容都被视为代码。 不
缩进是必要的：
~~~~~~~
如果 (a > 3) {
移动船（5 * 重力，向下）；
}
~~~~~~~
像常规代码块一样，围栏代码块必须与周围的文本分开
空行。
如果代码本身包含一行波浪线或反引号，只需使用更长的波浪线行
或在开始和结束时使用反引号：
~~~~~~~~~~~~~~~~
~~~~~~~~~~
代码包括波浪号
~~~~~~~~~~
~~~~~~~~~~~~~~~~
扩展： 反引号_code_blocks
与 fenced_code_blocks 相同，但使用反引号 (`) 而不是波浪号 (~)。
扩展： 围栏代码属性
或者，您可以使用以下语法将属性附加到围栏或反引号代码块：
~~~~ {#mycode .haskell .numberLines startFrom="100"}
排序 [] = []
qsort (x:xs) = qsort (filter (< x) xs) ++ [x] ++
qsort（过滤器（> = x）xs）
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
这里 mycode 是一个标识符，haskell 和 numberLines 是类，而 startFrom 是一个
值为 100 的属性。某些输出格式可以使用此信息来执行语法
突出显示。 目前，使用此信息的唯一输出格式是 HTML 和
乳胶。 如果您的输出格式和语言支持突出显示，则代码
上面的块将突出显示，并带有编号的行。 （要查看哪些语言是
支持，做 pandoc --version。）否则，上面的代码块会出现如下：
...
还可以使用快捷方式来指定代码块的语言：
```哈斯克尔
排序 [] = []
````
这等效于：
``` {.haskell}
排序 [] = []
````
如果 fenced_code_attributes 扩展被禁用，但输入包含类属性
对于代码块，第一个类属性将在打开围栏后打印为
空话。
要防止所有突出显示，请使用 --no-highlight 标志。 要设置突出显示样式，
使用 --highlight-style。 有关突出显示的更多信息，请参阅语法突出显示，
联络一位教师
Line 块
扩展： 线块
行块是一系列以竖线 (|) 开头的行，后跟一个空格。
分行将保留在输出中，任何前导空格也将保留；
否则，这些行将被格式化为 Markdown。 这对诗歌和
地址：
| 打油诗包装笑解剖
| 在相当经济的空间中。
| 但我见过的好人
| 所以很少是干净的
| 而干净的很少是滑稽的
| 200 主街
| 加州伯克利 94718
如果需要，这些行可以硬包装，但续行必须以
空间。
| 尊敬的尊敬和正义的塞缪尔·L。
警员，年少者
| 200 主街
| 加州伯克利 94718
这个语法是从 reStructuredText 借来的。
书单
子弹 名单
项目符号列表是项目符号列表项的列表。 项目符号列表项以项目符号开头
（*、+ 或 -）。 这是一个简单的例子：
* 一
* 二
* 三
这将产生一个“紧凑”列表。 如果你想要一个“松散”的列表，其中每个项目都是
格式化为段落，在项目之间放置空格：
* 一
* 二
* 三
子弹不需要与左边距齐平； 它们可能缩进一、二或
三个空间。 项目符号后面必须跟空格。
如果后续行与第一行（项目符号之后）齐平，则列表项看起来最好：
* 这是我的第一次
项目清单。
* 和我的第二个。
但 Markdown 也允许“懒惰”的格式：
* 这是我的第一次
项目清单。
* 和我的第二个。
这款 四格 排除
一个列表项可能包含多个段落和其他块级内容。 然而，
后续段落之前必须有一个空行并缩进四个空格或一个制表符。
如果第一段与其余部分对齐，列表会更好看：
* 第一段。
继续。
* 第二段。 带有必须缩进的代码块
八个空格：
{ 代码 }
列表项可能包括其他列表。 在这种情况下，前面的空行是可选的。
嵌套列表必须缩进四个空格或一个制表符：
* 水果
+苹果
- 麦金塔
- 红色美味
+梨
+ 桃子
* 蔬菜
+ 西兰花
+ 甜菜
如上所述，Markdown 允许您“懒惰”地编写列表项，而不是缩进
延续线。 但是，如果列表中有多个段落或其他块
项，每个项的第一行必须缩进。
+ 懒惰的，懒惰的，清单
项目。
+ 另一个； 这看起来
坏但合法。
第二段第二段
项目清单。
请注意： 虽然连续段落的四空格规则来自官方
Markdown 语法指南，参考实现，Markdown.pl，不遵循它。 所以
当作者缩进时 pandoc 将给出与 Markdown.pl 不同的结果
连续段落少于四个空格。
Markdown 语法指南没有明确四空格规则是否适用于 所有
列表项中的块级内容； 它只提到段落和代码块。 但它
意味着该规则适用于所有块级内容（包括嵌套列表），并且
pandoc 就是这样解释的。
有序 名单
有序列表就像项目符号列表一样工作，只是项目以枚举数开头
而不是子弹。
在标准 Markdown 中，枚举数是十进制数，后跟一个句点和一个空格。
数字本身被忽略，因此此列表之间没有区别：
1.一
2. 两个
3.三个
还有这个：
5.一
7. 两个
1.三个
扩展： 花式列表
与标准 Markdown 不同，pandoc 允许用大写和
小写字母和罗马数字，以及阿拉伯数字。 列表标记可能是
括在括号中或后跟单个右括号或句点。 他们必须是
与后面至少有一个空格的文本分开，并且，如果列表标记是一个
带句点的大写字母，至少有两个空格。
Fantasy_lists 扩展还允许将“#”用作有序列表标记来代替
一个数字：
#. 一
#. 二
扩展： 起始编号
Pandoc 还注意使用的列表标记的类型，以及起始编号，
并且这两个都尽可能以输出格式保留。 因此，以下
产生一个带有数字后跟一个括号的列表，从 9 开始，还有一个
带有小写罗马数字的子列表：
9) 第九
10) 第十
11) 第十一
一世。 次要
ii. 子二
三、 小三
每次使用不同类型的列表标记时，Pandoc 都会启动一个新列表。 所以
以下将创建三个列表：
(2) 两个
(5) 三
1。 四个
* 五
如果需要默认列表标记，请使用 #.:
#. 一
#. 二
#. 三
定义 名单
扩展： 定义列表
Pandoc 支持定义列表，使用 PHP Markdown Extra 的语法和一些
扩展。
术语1
: 定义 1
带有*内联标记*的第 2 学期
: 定义 2
{ 一些代码，定义 2 的一部分 }
定义 2 的第三段。
每个术语必须占一行，可以选择后跟一个空行，并且必须
后跟一个或多个定义。 定义以冒号或波浪号开头，即
可以缩进一两个空格。
一个术语可能有多个定义，每个定义可能由一个或多个块组成
元素（段落、代码块、列表等），每个元素缩进四个空格或一个制表位。
定义的主体（包括第一行，冒号或波浪号除外）
应该缩进四个空格。 但是，与其他 Markdown 列表一样，您可以“懒惰地”
除了段落开头或其他块元素之外，省略缩进：
术语1
： 定义
懒惰的延续。
定义的第二段。
如果在定义前留下空格（如上例所示），则
定义将被视为一个段落。 在某些输出格式中，这意味着更大
术语/定义对之间的间距。 对于更紧凑的定义列表，省略空格
在定义之前：
术语1
~定义1
术语2
~ 定义 2a
~ 定义 2b
请注意，定义列表中的项目之间需要空格。 （一种松散的变体
这个要求，但不允许“懒惰”硬包装，可以激活
compact_definition_lists：请参阅下面的非 pandoc 扩展。）
编号 例子 名单
扩展： 示例列表
特殊列表标记@ 可用于按顺序编号的示例。 第一个名单
带有@ 标记的项目将编号为“1”，下一个为“2”，依此类推，贯穿整个过程
文档。 编号的示例不必出现在一个列表中； 每个新列表使用@
将占用上次停止的地方。 因此，例如：
(@) 我的第一个示例将编号为 (1)。
(@) 我的第二个例子将编号为 (2)。
举例说明。
(@) 我的第三个例子将编号为 (3)。
编号的示例可以在文档的其他地方进行标记和引用：
(@good) 这是一个很好的例子。
正如 (@good) 所示，...
标签可以是任何字母数字字符、下划线或连字符的字符串。
紧凑 和 松 名单
在一些涉及列表的“边缘情况”上，Pandoc 的行为与 Markdown.pl 不同。
考虑这个来源：
+首先
+ 第二：
- 费用
- 飞
- 敌人
+ 第三
Pandoc 将其转换为“紧凑列表”（没有标签围绕“第一”，“第二”，
或“第三”），而 Markdown “第二”和“第三”（但不是“第一”）周围的标签，
因为“第三”周围有空格。 Pandoc 遵循一个简单的规则：如果文本是
后跟一个空行，它被视为一个段落。 因为“Second”后面跟着一个
列表，而不是空行，它不被视为段落。 名单是这样的事实
后跟一个空行是无关紧要的。 （注意：Pandoc 以这种方式工作，即使
指定 markdown_strict 格式。 此行为与官方一致
Markdown 语法描述，即使它与 Markdown.pl 的不同。）
结束 a 名单
如果您想在列表之后放置一个缩进的代码块怎么办？
- 项目一
- 第二项
{ 我的代码块 }
麻烦！ 这里 pandoc（像其他 Markdown 实现一样）将 { my code block } 视为
第二项的第二段，而不是作为代码块。
要在第二项之后“切断”列表，您可以插入一些非缩进的内容，例如
HTML 注释，不会产生任何格式的可见输出：
- 项目一
- 第二项
{ 我的代码块 }
如果您想要两个连续的列表而不是一个大列表，您可以使用相同的技巧：
1.一
2. 两个
3.三个
1. 联合国
2. 做
3. 三
横 定位、竞价/采购和分析/优化数字媒体采购，但算法只不过是解决问题的操作和规则。
一行包含三个或更多 *、- 或 _ 字符（可选地由
空格）产生一个水平规则：
* * * *
---------------
表
可以使用四种表。 前三种假设使用一个
固定宽度字体，例如 Courier。 第四种可按比例间隔使用
字体，因为它不需要排列列。
扩展： 表标题
可以选择为所有 4 种表格提供标题（如
下面的例子）。 标题是以字符串 Table:（或只是 :) 开头的段落，
这将被剥离。 它可能出现在表格之前或之后。
扩展： 简单表
简单的表如下所示：
右左居中默认
-------- ------ ---------- --------
12 12 12 12
123 123 123 123
1 1 1 1
表：简单表语法的演示。
标题和表格行必须各占一行。 列对齐方式由
标题文本相对于其下方虚线的位置：
· 如果虚线与右侧的标题文本齐平但超出了它
在左侧，该列右对齐。
· 如果虚线与左侧的标题文本齐平但超出了它
在右侧，该列左对齐。
· 如果虚线超出两侧的标题文本，则该列居中。
· 如果虚线与两侧的标题文本齐平，则默认对齐方式为
使用（在大多数情况下，这将被保留）。
该表格必须以一个空行或一行破折号后跟一个空行结束。
如果使用虚线结束表格，则可以省略列标题。 为了
例：
-------- ------ ---------- --------
12 12 12 12
123 123 123 123
1 1 1 1
-------- ------ ---------- --------
省略标题时，以第一行为基础确定列对齐方式
表体。 因此，在上表中，列将是右、左、中和
分别右对齐。
扩展： 多行表
多行表格允许标题和表格行跨越多行文本（但单元格
不支持跨越表格的多列或多行）。 下面是一个例子：
-------------------------------------------------- -----------
居中默认右左
标题对齐对齐对齐
----------- ------- --------------- ----------------- --------
第一行 12.0 行示例
跨越多行。
第二行 5.0 这是另一个。 笔记
之间的空行
行。
-------------------------------------------------- -----------
表：这是标题。 它也可能跨越
多行。
这些工作就像简单的表，但有以下区别：
· 它们必须以一行破折号开始，在标题文本之前（除非标题是
省略）。
· 它们必须以一行破折号结束，然后是一个空行。
· 行之间必须以空行分隔。
在多行表中，表解析器关注列的宽度，而
作者试图在输出中重现这些相对宽度。 所以，如果你发现其中之一
输出中的列太窄，请尝试在 Markdown 源中加宽它。
在多行表和简单表中可以省略标题：
----------- ------- --------------- ----------------- --------
第一行 12.0 行示例
跨越多行。
第二行 5.0 这是另一个。 笔记
之间的空行
行。
----------- ------- --------------- ----------------- --------
：这是一个没有标题的多行表。
多行表可能只有一行，但应遵循该行
由一个空行（然后是结束表格的一行破折号），或者表格可能是
解释为一个简单的表。
扩展： 网格表
网格表如下所示：
：示例网格表。
+--------------+---------------+----------------- ---+
| 水果 | 价格 | 优势 |
+================+==================+================ ===+
| 香蕉 | 1.34 美元 | - 内置包装|
| | | - 鲜艳的色彩|
+--------------+---------------+----------------- ---+
| 橙子 | 2.10 美元 | - 治疗坏血病 |
| | | - 美味|
+--------------+---------------+----------------- ---+
=s 行将表头与表体分开，对于 a 可以省略
无头表。 网格表的单元格可以包含任意块元素（多个
段落、代码块、列表等）。 不支持对齐，也不支持对齐的单元格
跨越多列或多行。 使用 Emacs 表格模式可以轻松创建网格表格。
扩展： 管道表
管道表如下所示：
| 对 | 左 | 默认 | 中心 |
|------:|:-----|--------|:------:|
| 12 | 12 12 | 12 XNUMX | XNUMX XNUMX | XNUMX
| 123 | 123 123 | 123 XNUMX | XNUMX XNUMX | XNUMX
| 1 | 1 1 | 1 XNUMX | XNUMX XNUMX | XNUMX
: 管道表语法演示。
语法与 PHP Markdown Extra 表相同。 开始和结束管道
字符是可选的，但所有列之间都需要管道。 冒号表示
列对齐如图所示。 标题不能省略。 要模拟无头表，
包括一个带有空白单元格的标题。
由于管道指示列边界，列不需要垂直对齐，如
他们在上面的例子中。 所以，这是一个完全合法（虽然丑陋）的管道表：
水果| 价格
-----|-----：
苹果|2.05
梨|1.37
橙色|3.09
管道表的单元格不能包含像段落和列表这样的块元素，并且
不能跨越多行。 如果管道表包含可打印内容为
比列宽（见--columns）宽，然后单元格内容将换行，用
由分隔线的宽度确定的相对单元格宽度。
注意：pandoc 还可以识别以下形式的管道表，可以通过以下方式生成
Emacs 的 orgtbl 模式：
| 一 | 二 |
|-----+--------|
| 我的 | 表|
| 是 | 不错|
不同之处在于使用了 + 而不是 |。 不支持其他orgtbl 功能。
特别是，要获得非默认的列对齐方式，您需要像上面一样添加冒号。
元数据 块
扩展： pandoc_标题_块
如果文件以标题栏开头
％ 标题
% 作者（以分号分隔）
％ 日期
它将被解析为书目信息，而不是常规文本。 （它将被用于，对于
例如，在独立 LaTeX 或 HTML 输出的标题中。）该块可能只包含一个
标题、标题和作者，或所有三个元素。 如果您想包括作者但
没有标题，或标题和日期但没有作者，您需要一个空行：
%
％ 作者
% 我的标题
%
% 15 年 2006 月 XNUMX 日
标题可以占据多行，但续行必须以空格开头，
从而：
% 我的标题
在多条线上
如果一个文档有多个作者，作者可以放在单独的行上，前导
空格，或用分号分隔，或两者兼而有之。 因此，以下所有内容都是等效的：
% 作者一
作者二
% 作者一； 作者二
% 作者一；
作者二
日期必须在一行中。
所有三个元数据字段都可能包含标准的内联格式（斜体、链接、
脚注等）。
标题块将始终被解析，但只有在以下情况下它们才会影响输出
--standalone (-s) 选项被选中。 在 HTML 输出中，标题将出现两次：一次在
文档头——这是将出现在浏览器窗口顶部的标题
-- 并且一次在文档正文的开头。 文件头中的标题可以
附加一个可选的前缀（--title-prefix 或 -T 选项）。 正文中的标题
显示为具有“title”类的 H1 元素，因此可以使用
CSS。 如果使用 -T 指定了标题前缀并且文档中没有出现标题块，
标题前缀将被自己用作 HTML 标题。
手册页作者提取标题、手册页节号和其他页眉和页脚
来自标题行的信息。 假定标题是标题上的第一个单词
行，可以选择以括号中的（一位数）节号结尾。
（标题和括号之间不应该有空格。）这之后的任何内容都是
假定为附加的页脚和页眉文本。 单个管道字符 (|) 应该是
用于将页脚文本与页眉文本分开。 因此，
% 潘多克(1)
将产生一个标题为 PANDOC 和第 1 节的手册页。
% 潘多克(1) Pandoc 用户手册
页脚中还将包含“Pandoc 用户手册”。
% 潘多克(1) Pandoc 用户手册 | 4.0版
标题中还将包含“Version 4.0”。
扩展： yaml_元数据_块
YAML 元数据块是一个有效的 YAML 对象，由一行三个连字符 (---) 分隔
在顶部和一行三个连字符 (---) 或三个点 (...) 在底部。 一个 YAML
元数据块可能出现在文档的任何位置，但如果它不在开头，则它
前面必须有一个空行。 （请注意，由于 pandoc 连接的方式
当提供多个输入文件时，您也可以将元数据保存在单独的 YAML 中
文件并将其作为参数传递给 pandoc，以及您的 Markdown 文件：
pandoc chap1.md chap2.md chap3.mdmetadata.yaml -s -o book.html
请确保 YAML 文件以 --- 开头并以 --- 或 .... 结尾。
元数据将从 YAML 对象的字段中获取并添加到任何现有的
文档元数据。 元数据可以包含列表和对象（任意嵌套），但所有
字符串标量将被解释为 Markdown。 名称以下划线结尾的字段
将被 pandoc 忽略。 （它们可能会被外部处理器赋予一个角色。）
一个文档可能包含多个元数据块。 元数据字段将被合并
通过 偏左 工会：如果两个元数据块尝试设置相同的字段，则
将采用第一个块的值。
当 pandoc 与 -t markdown 一起使用来创建 Markdown 文档时，一个 YAML 元数据块
仅在使用 -s/--standalone 选项时才会生成。 所有元数据将
出现在文档开头的单个块中。
请注意，必须遵循 YAML 转义规则。 因此，例如，如果标题包含
冒号，它必须被引用。 管道字符 (|) 可用于开始缩进块
这将按字面解释，无需转义。 这个表格是必须的
当字段包含空行时：
---
title: '这是标题：它包含一个冒号'
作者：
- 姓名：作者一
隶属关系：某处大学
- 姓名：作者二
隶属：无处大学
标签： [无，虚无]
摘要： |
这是摘要。
它由两段组成。
...
模板变量将从元数据中自动设置。 因此，例如，在
编写 HTML，变量 abstract 将被设置为 HTML 中的 Markdown 等价物
抽象领域：
这是摘要。
它由两段组成。
注意：默认模板中的 author 变量需要一个简单的列表或字符串。 到
使用示例中的结构化作者，您需要一个自定义模板。 例如：
$for(作者)$
$如果（作者名）$
$author.name$$if(author.affiliation)$ ($author.affiliation$)$endif$
$其他$
$作者$
$结尾$
$结束$
反斜杠 逃逸
扩展： 所有_symbols_escapable
除了在代码块或内联代码内，任何以
反斜杠将按字面意思处理，即使它通常表示格式。
因此，例如，如果一个人写
*\*你好\**
一个会得到
*你好*
而不是
你好
这条规则比标准的 Markdown 规则更容易记住，它只允许
以下字符要被反斜杠转义：
\`*_{}[]()>#+-.!
（但是，如果使用 markdown_strict 格式，则将使用标准的 Markdown 规则。）
反斜杠转义的空格被解析为不间断空格。 它将出现在 TeX 输出中
作为 ~ 并在 HTML 和 XML 中作为 \ 或 \ 。
反斜杠转义的换行符（即出现在行尾的反斜杠）被解析
作为硬断线。 它将在 TeX 输出中显示为 \\ 并在 HTML 中显示为. 这是
一个很好的替代 Markdown 的“隐形”方式来指示使用两个硬换行符
一行的尾随空格。
反斜杠转义在逐字上下文中不起作用。
智能 标点
延期
如果指定了 --smart 选项，pandoc 将产生排版正确的输出，
将直引号转换为卷引号，--- 到 em-dashes，-- 到 en-dashes，以及 ...
椭圆。 在某些缩写后插入不间断空格，例如“先生”。
注意：如果您的 LaTeX 模板或任何包含的头文件调用 csquotes 包，
pandoc 将自动检测到这一点，并使用 \enquote{...} 引用文本。
排队 格式
重点
至 强调 一些文本，用 *s 或 _ 包围它，如下所示：
这段文字_用下划线_强调，而这
*用星号强调*。
双 * 或 _ 产生 强烈 重点:
这是**强烈强调**和__带下划线__。
由空格或反斜杠转义的 * 或 _ 字符不会触发强调：
这是*不强调*，\*也不是\*。
扩展： 字内下划线
因为 _ 有时在单词和标识符中使用，pandoc 不解释 _
由字母数字字符包围作为强调标记。 如果你想强调
只是一个词的一部分，使用*：
可行*可行*，不可行*。
三振出局
扩展： 删除线
要使用水平线删除一段文本，请以 ~~ 开头和结尾。 因此，
例如，
这个~~是删文~~
上标 和 下标
扩展： 上标， 下标
上标可以用 ^ 字符包围上标文本；
下标可以通过用 ~ 字符包围下标文本来编写。 因此，对于
例，
H~2~O是液体。 2^10^ 是 1024。
如果上标或下标文本包含空格，则必须对这些空格进行转义
带反斜杠。 （这是为了防止意外的上标和下标通过
~ 和 ^ 的普通用法。）因此，如果您希望字母 P 带有下标“a cat”，
使用 P~a\ cat~，而不是 P~a cat~。
逐字
要逐字制作一小段文本，请将其放在反引号内：
`>>=` 和 `>>` 有什么区别？
如果逐字文本包含反引号，请使用双反引号：
这是一个字面的反引号 ```` 。
（开始反引号之后和结束反引号之前的空格将被忽略。）
一般规则是逐字跨度以一串连续的反引号开头
（可选后跟一个空格）并以具有相同数量反引号的字符串结尾
（可选地前面有一个空格）。
请注意，反斜杠转义（和其他 Markdown 结构）在逐字记录中不起作用
上下文：
这是一个反斜杠后跟一个星号：`\*`。
扩展： 内联代码属性
属性可以附加到逐字文本，就像围栏代码块一样：
`<$>`{.haskell}
S小号 粒
要编写小型大写字母，您可以使用 HTML span 标签：
小帽子
（分号是可选的，冒号后面可能有空格。）这将适用于所有
支持小型大写字母的输出格式。
数学
扩展： tex_math_dollars
两个 $ 字符之间的任何内容都将被视为 TeX 数学。 开头的 $ 必须有一个
紧靠其右侧的非空格字符，而结束的 $ 必须有一个非空格
紧跟其左侧的字符，并且后面不能紧跟数字。 因此，
20,000 美元和 30,000 美元不会被解析为数学。 如果由于某种原因您需要将文本括在
文字 $ 字符，反斜杠转义它们，它们不会被视为数学分隔符。
TeX 数学将以所有输出格式打印。 它的呈现方式取决于输出
格式：
降价， 乳胶， Emacs的 组织 模式， 语境
它将在 $ 字符之间逐字显示。
reStructuredText的
它将使用解释文本角色 :math: 呈现。
AsciiDoc
它将呈现为 latexmath:[...]。
特讯
它将在@math 命令中呈现。
groff的 男子
它将在没有 $ 的情况下逐字呈现。
媒体维基， 维基百科
它会在里面渲染标签。
纺织品
它将在标签内呈现。
即时通讯文件， 打开文档， ODT
如果可能，它将使用 unicode 字符呈现，否则将
逐字出现。
DocBook的
如果使用 --mathml 标志，它将在内联方程中使用 MathML 呈现
或非正式方程式标签。 否则，如果可能，它将使用 unicode 呈现
字符。
DOCX 它将使用 OMML 数学标记呈现。
小说书2
如果使用 --webtex 选项，则使用 Google Charts 将公式呈现为图像
或其他兼容的网络服务，下载并嵌入电子书中。 否则，
它们将逐字显示。
HTML， 滑溜溜的， DZ幻灯片， S5， EPUB
数学在 HTML 中的呈现方式将取决于所选的命令行选项：
1. 默认是尽可能使用 unicode 字符渲染 TeX 数学，
与 RTF、DocBook 和 OpenDocument 输出一样。 公式被放在一个跨度内
使用 class="math"，这样它们的样式就可能与周围的不同
如果需要，文本。
2. 如果使用--latexmathml 选项，TeX math 将显示在 $ 或 $$ 之间
字符并放入带有类 LaTeX 的标签。 LaTeXMathML 脚本将
用于将其呈现为公式。 （此技巧不适用于所有浏览器，
但它适用于 Firefox。 在不支持 LaTeXMathML 的浏览器中，TeX math
将逐字显示在 $ 字符之间。）
3. 如果使用了 --jsmath 选项，TeX 数学将被放入标签内（对于
内联数学）或带有类数学的标签（用于显示数学）。 jsMath
脚本将用于渲染它。
4. 如果使用--mimetex 选项，将调用mimeTeX CGI 脚本
为每个 TeX 公式生成图像。 这应该适用于所有浏览器。 这
--mimetex 选项将可选的 URL 作为参数。 如果未指定 URL，则它
将假定 mimeTeX CGI 脚本位于 /cgi-bin/mimetex.cgi。
5. 如果使用--gladtex 选项，TeX 公式将包含在标签在
HTML 输出。 生成的 htex 文件可能会被gladTeX 处理，
这将为每个公式生成图像文件和一个带有链接的 HTML 文件
这些图像。 所以，程序是：
pandoc -s --gladtex myfile.txt -o myfile.htex
gladtex -d myfile-images myfile.htex
# 在 myfile-images 中生成 myfile.html 和图像
6. 如果使用--webtex 选项，TeX 公式将被转换为标签
链接到将公式转换为图像的外部脚本。 公式
将被 URL 编码并与提供的 URL 连接。 如果没有网址
指定，将使用 Google Chart API
(http://chart.apis.google.com/chart?cht=tx&chl=）。
7. 如果使用 --mathjax 选项，TeX 数学将显示在 \(...\) 之间（对于
内联数学）或 \[...\]（用于显示数学）并放入带有 class 的标签
数学。 MathJax 脚本将用于将其呈现为公式。
原 HTML
扩展： 原始html
Markdown 允许您在文档中的任何位置插入原始 HTML（或 DocBook）（除了
逐字上下文，其中 <、> 和 & 被逐字解释）。 （从技术上讲，这不是
一个扩展，因为标准 Markdown 允许它，但它已被扩展，以便
如果需要，可以禁用它。）
原始 HTML 在 HTML、S5、Slidy、Slideous、DZSlides、EPUB、
Markdown 和 Textile 输出，并以其他格式抑制。
扩展： markdown_in_html_blocks
标准 Markdown 允许您包含 HTML“块”：平衡的 HTML 块
用空行与周围文本隔开的标签，开始和结束于
左边距。 在这些块中，一切都被解释为 HTML，而不是 Markdown； 所以
（例如），* 不表示强调。
当使用 markdown_strict 格式时，Pandoc 的行为是这样的； 但默认情况下，pandoc
将 HTML 块标记之间的材料解释为 Markdown。 因此，例如，pandoc 将
转
*一*
[一条链接]（http://google.com)
成
一
<a href="/http://google.com">一个链接
而 Markdown.pl 将保持原样。
此规则有一个例外：文本之间 and tags is not
解释为降价。
这种与标准 Markdown 的背离应该更容易将 Markdown 与 HTML 混合
块元素。 例如，你可以用标签
而不会阻止它被解释为 Markdown。
扩展： 原生_div
使用原生 pandoc Div 块作为内部内容标签。 在大多数情况下，这应该
给出与 markdown_in_html_blocks 相同的输出，但它使编写 pandoc 更容易
过滤器来操作块组。
扩展： 原生跨度
对标签内的内容使用原生 pandoc Span 块。 在大多数情况下，这
应该提供与 raw_html 相同的输出，但它可以更容易地编写 pandoc 过滤器
操作内联组。
原 TeX的
扩展： 原始纹理
除了原始 HTML 之外，pandoc 还允许将原始 LaTeX、TeX 和 ConTeXt 包含在一个
文档。 内联 TeX 命令将被保留并原封不动地传递给 LaTeX 和
上下文作家。 因此，例如，您可以使用 LaTeX 来包含 BibTeX 引文：
这个结果在 \cite{jones.1967} 中得到了证明。
请注意，在 LaTeX 环境中，例如
\begin{表格}{|l|l|}\hline
年龄和频率 \\ \hline
18--25 & 15 \\
26--35 & 33 \\
36--45 & 22 \\ \hline
\end{表格}
开始和结束标签之间的材料将被解释为原始 LaTeX，而不是作为
降价。
在 Markdown、LaTeX 和 ConTeXt 以外的输出格式中，内联 LaTeX 被忽略。
胶乳 宏
扩展： 乳胶宏
对于 LaTeX 以外的输出格式，pandoc 将解析 LaTeX \newcommand 和 \renewcommand
定义并将生成的宏应用于所有 LaTeX 数学。 因此，例如，
以下将适用于所有输出格式，而不仅仅是 LaTeX：
\newcommand{\tuple}[1]{\langle #1 \rangle}
$\元组{a, b, c}$
在 LaTeX 输出中，\newcommand 定义将简单地传递给输出。
链接
Markdown 允许以多种方式指定链接。
自动表 链接
如果您将 URL 或电子邮件地址括在尖括号中，它将成为一个链接：
<http://google.com>
<[电子邮件保护]>
排队 链接
内联链接由方括号中的链接文本组成，后跟中的 URL
括弧。 （可选地，URL 可以跟在引号中的链接标题之后。）
这是一个[内联链接](/url)，这里是[一个带有
一个标题]（http://fsf.org “点击这里玩得开心！”）。
括号部分和括号部分之间不能有空格。 链接
文本可以包含格式（例如强调），但标题不能。
内联链接中的电子邮件地址不会被自动检测，因此它们必须以
站长：
[写信给我！](站长：[电子邮件保护])
型号参考 链接
An 明确的 参考链接有两部分，链接本身和链接定义，
可能出现在文档的其他地方（链接之前或之后）。
链接由方括号中的链接文本和方括号中的标签组成。
（两者之间可以有空格。）链接定义由括号中的标签组成，
后跟一个冒号和一个空格，后跟 URL，以及可选的（在一个空格后）一个
用引号或括号括起来的链接标题。 标签不能被解析为
引文（假设引文扩展已启用）：引文优先于
链接标签。
下面是一些例子：
[我的标签1]：/foo/bar.html“我的标题，可选”
[我的标签 2]：/foo
[我的标签3]： http://fsf.org （自由软件基金会）
[我的标签 4]：/bar#special '单引号中的标题'
URL 可以选择用尖括号括起来：
[我的标签5]：http://foo.bar.baz>
标题可能在下一行：
[我的标签3]： http://fsf.org
“自由软件基金会”
请注意，链接标签不区分大小写。 所以，这将起作用：
这是[我的链接][FOO]
[Foo]：/bar/baz
在 含蓄 参考链接，第二对括号为空：
见[我的网站][]。
[我的网站]： http://foo.bar.baz
注意：在 Markdown.pl 和大多数其他 Markdown 实现中，参考链接定义
不能出现在嵌套结构中，例如列表项或块引号。 潘多克升降机
这种看似随意的限制。 所以以下在 pandoc 中很好，但不是在
大多数其他实现：
> 我的街区 [quote]。
>
> [引用]: /foo
扩展： 快捷方式参考链接
在一个 捷径 参考链接，第二对括号可以完全省略：
见[我的网站]。
[我的网站]： http://foo.bar.baz
内部 链接
要链接到同一文档的另一部分，请使用自动生成的
标识符（请参阅标题标识符）。 例如：
请参阅[简介](#introduction)。
or
请参阅[简介]。
[介绍]：#介绍
目前支持 HTML 格式的内部链接（包括 HTML 幻灯片和
EPUB)、LaTeX 和 ConTeXt。
图片
紧跟在前面的链接！ 将被视为图像。 链接文本将是
用作图像的替代文字：
![电影卷轴]
[电影卷轴]：movie.gif
扩展： 隐含数字
在段落中单独出现的图像将被呈现为带有标题的图形。
（在 LaTeX 中，将使用图形环境；在 HTML 中，图像将放置在一个 div 中
带有类图，以及带有类标题的 ap 中的标题。）图像的 alt
text 将用作标题。
如果你只想要一个普通的内嵌图像，只要确保它不是唯一的
段落。 一种方法是在图像后插入一个不间断空格：
\
扩展： 链接属性
可以在链接和图像上设置属性：
内联 {#id .class width=30 height=20px}
和带有属性的参考 ![image][ref]。
[ref]: foo.jpg "可选标题" {#id .class key=val key2="val 2"}
（当仅使用 #id 和 .class 时，此语法与 PHP Markdown Extra 兼容。）
对于 HTML 和 EPUB，除宽度和高度外的所有属性（但包括 srcset 和尺寸）
原样通过。 其他作者忽略不支持的属性
他们的输出格式。
图像的宽度和高度属性被特殊处理。 当没有使用时
单位，单位假定为像素。 但是，以下任何单位标识符
可以使用：px、cm、mm、in、inch 和 %。 数字之间不能有任何空格
和单位。 例如：
{ 宽度=50% }
· 尺寸被转换为英寸，以便以 LaTeX 等基于页面的格式输出。
尺寸转换为像素，以类似 HTML 的格式输出。 使用 --dpi
用于指定每英寸像素数的选项。 默认值为 96dpi。
· % 单位通常与一些可用空间有关。 例如上面的例子
将呈现为(HTML),
\includegraphics[width=0.5\textwidth]{file.jpg} (LaTeX)，或
\externalfigure[file.jpg][width=0.5\textwidth] (ConTeXt)。
· 某些输出格式具有类 (ConTeXt) 或唯一标识符 (LaTeX) 的概念
\caption)，或两者 (HTML)。
· 当没有指定width或height属性时，回退是看图片
分辨率和嵌入在图像文件中的 dpi 元数据。
脚注
扩展： 脚注
Pandoc 的 Markdown 允许使用以下语法添加脚注：
这是一个脚注参考，[^1] 和另一个。[^longnote]
[^1]：这是脚注。
[^longnote]：这是一个有多个块的。
随后的段落缩进以表明它们
属于上一个脚注。
{一些.代码}
整个段落可以缩进，或者只是第一个
线。 这样，多段脚注就像
多段列表项。
这一段不会成为注释的一部分，因为它
没有缩进。
脚注引用中的标识符不能包含空格、制表符或换行符。 这些
标识符仅用于将脚注引用与注释本身相关联； 在里面
输出，脚注将按顺序编号。
脚注本身不需要放在文件的末尾。 他们可能会出现
除了其他块元素（列表、块引用、表格等）之外的任何地方。
扩展： 内联注释
也允许使用内嵌脚注（尽管与常规注释不同，它们不能包含
多个段落）。 语法如下：
这是内联注释。^[内联注释更容易写，因为
您不必选择标识符并向下移动以键入
笔记。]
内联脚注和常规脚注可以自由混合。
参考文献
扩展： 引用
使用外部过滤器 pandoc-citeproc，pandoc 可以自动生成引文和
多种风格的参考书目。 基本用法是
pandoc --过滤 pandoc-citeproc myinput.txt
为了使用此功能，您需要使用
YAML 元数据部分中的参考书目元数据字段，或 --bibliography 命令行
争论。 您可以提供多个 --bibliography 参数或设置参考书目元数据
字段到 YAML 数组，如果你想使用多个参考书目文件。 参考书目可以
具有以下任何一种格式：
格式文件扩展名
────────────────────────────────
中文提供.bib
中文提供.bibtex
科帕克.copac
中超 JSON .json
CSL YAML .yaml
尾注.enl
尾注 XML .xml
ISI.wos
医学线.medline
模组 .mods
RIS
请注意，.bib 可用于 BibTeX 和 BibLaTeX 文件； 使用 .bibtex 强制
中文百科全书。
请注意， pandoc-citeproc --bib2json 和 pandoc-citeproc --bib2yaml 可以生成 .json 和
任何受支持格式的 .yaml 文件。
现场标记：在 BibTeX 和 BibLaTeX 数据库中，pandoc-citeproc 解析
乳胶标记； 在 CSL YAML 数据库中，pandoc Markdown； 在 CSL JSON 数据库中，一个
类似 HTML 的标记：
斜体
...
无所畏惧
style="font-variant:small-caps;">... or ...
小首都
...
下标
...
标
class="nocase">...
防止短语大写为标题大小写
pandoc-citeproc -j 和 -y 相互转换 CSL JSON 和 CSL YAML 格式
可能。
作为使用 --bibliography 或 YAML 指定书目文件的替代方法
元数据字段参考书目，您可以直接在参考文献中包含引文数据
文档的 YAML 元数据字段。 该字段应包含 YAML 编码的数组
参考资料，例如：
---
参考资料：
- 类型：文章期刊
编号：WatsonCrick1953
作者：
- 家庭：华生
给定：JD
- 家庭：克里克
给定：FHC
发布：
日期部分：
--1953
– 4天内
– 25天内
标题：'核酸的分子结构：脱氧核糖的结构
核酸'
title-short: 核酸的分子结构
容器标题：自然
体积：171
问题：4356
第 737-738 页
DOI：10.1038/171737a0
网址： http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
语言: en-GB
...
（pandoc-citeproc --bib2yaml 可以从其中之一的参考书目文件中生成这些
支持的格式。）
引文和参考文献可以使用引文样式支持的任何样式进行格式化
语言，列在 Zotero Style Repository 中。 这些文件是使用
--csl 选项或 csl 元数据字段。 默认情况下， pandoc-citeproc 将使用 Chicago
样式手册作者-日期格式。 CSL 项目提供了关于
查找和编辑样式。
要使您的引文超链接到相应的参考书目条目，请添加
链接引用：对你的 YAML 元数据来说是真实的。
引文放在方括号内并用分号分隔。 每个引文必须
有一个键，由“@”+数据库中的引文标识符组成，并且可以
可选地具有前缀、定位符和后缀。 引文关键字必须以
字母、数字或 _，并且可能包含字母数字、_ 和内部标点符号
(:.#$%&-+?<>~/)。 这里有些例子：
废话废话[见@doe99，第33-35页； 还有@smith04，章。 1]。
废话废话 [@doe99，第 33-35、38-39 和 *passim*]。
废话废话[@smith04; @doe99]。
pandoc-citeproc 检测 CSL 语言环境文件中的定位器术语。 无论是缩写还是
接受非缩写形式。 在 en-US 语言环境中，定位器术语可以写成
单数或复数形式，如 book, bk./bks.; 章节，章节。/章节。 柱子，
列/列； 图，图/图； 对开，对开/对开； 编号，编号/编号； 线, l./ll.; 笔记，
n./nn.; opus, op./opp.; 页，页/页； 段，段/段； 部分，pt./pts.； 部分，
秒/秒； 子动词，sv/s.vv.； 诗句，v./vv.； 卷，卷/卷； ¶/¶¶ §/§§。 如果不
使用定位器术语，假定为“页面”。
@ 前的减号 (-) 将禁止在引文中提及作者。 这
当作者已经在文本中被提及时可能很有用：
史密斯说废话 [-@smith04]。
您还可以编写文本引用，如下所示：
@smith04 说废话。
@smith04 [p. 33] 胡说八道。
如果样式需要引用的作品列表，它将被放置在文章的末尾
文档。 通常，您会希望以适当的标题结束您的文档：
最后一段...
＃ 参考
参考书目将插入在此标题之后。 请注意，未编号的类将
将添加到此标题，以便该部分不会被编号。
如果您想在参考书目中包含项目而不在正文中实际引用它们
文本，您可以定义一个虚拟的 nocite 元数据字段并将引文放在那里：
---
注意： |
@项目1，@项目2
...
@项目3
在此示例中，文档将仅包含对 item3 的引用，但参考书目
将包含 item1、item2 和 item3 的条目。
对于 LaTeX 或 PDF 输出，您还可以使用 natbib 或 biblatex 来呈现参考书目。 在
为此，请指定上述参考书目文件，并添加 --natbib 或
--biblatex 参数到 pandoc 调用。 请记住，书目文件必须是
以各自的格式（BibTeX 或 BibLaTeX）。
有关更多信息，请参阅 pandoc-citeproc 手册页。
非pandoc 扩展
pandoc 中默认不启用以下 Markdown 语法扩展，但可能会
通过将 +EXTENSION 添加到格式名称来启用，其中 EXTENSION 是
延期。 因此，例如 markdown+hard_line_breaks 是 Markdown with hard line
休息。
扩展： list_without_preceding_blankline
允许在一个段落之后出现一个列表，中间没有空格。
扩展： 硬线中断
导致段落中的所有换行符都被解释为硬换行符而不是
空格。
扩展： 忽略换行符
导致段落中的换行符被忽略，而不是被视为空格或
作为硬线断裂。 此选项旨在用于东亚语言，其中
单词之间不使用空格，但为了便于阅读，文本被分成几行。
扩展： East_asian_line_breaks
导致段落中的换行符被忽略，而不是被视为空格或
作为硬换行符，当它们出现在两个东亚宽字符之间时。 这是一个
比 ignore_line_breaks 更好的选择，用于包含东亚范围混合的文本
字符和其他字符。
扩展： 表情符号
将文本表情符号解析为 :smile: 作为 Unicode 表情符号。
扩展： tex_math_single_反斜杠
导致 \( 和 \) 之间的任何内容被解释为内联 TeX 数学，以及任何内容
\[ 和 \] 之间被解释为显示 TeX 数学。 注意：这是一个缺点
扩展是它排除了转义 ( 和 [.
扩展： tex_math_double_反斜杠
导致 \\( 和 \\) 之间的任何内容被解释为内联 TeX 数学，以及任何内容
\\[ 和 \\] 之间被解释为显示 TeX 数学。
扩展： 降价属性
默认情况下，pandoc 将块级标签内的材料解释为 Markdown。 这
扩展更改了行为，以便 Markdown 仅在块级标签内解析，如果
标签的属性 markdown=1。
扩展： mmd_标题_块
在文档顶部启用 MultiMarkdown 样式的标题栏，例如：
标题：我的标题
添加一名作者
时间：9月1，2008
评论：这是一个示例 mmd 标题块，带有
跨越多行的字段。
有关详细信息，请参阅 MultiMarkdown 文档。 如果 pandoc_title_block 或
yaml_metadata_block 已启用，它将优先于 mmd_title_block。
扩展： 缩略语
解析 PHP Markdown Extra 缩写键，例如
*[HTML]：超文本标记语言
注意 pandoc 文档模型不支持缩写，所以如果这个扩展
启用，缩写键被简单地跳过（而不是被解析为
段）。
扩展： 自动链接_bare_uris
使所有绝对 URI 成为链接，即使没有被尖括号 <...> 包围。
扩展： ascii_标识符
使 auto_identifiers 生成的标识符成为纯 ASCII。 口音是
去掉带重音的拉丁字母，并省略非拉丁字母。
扩展： mmd_link_attributes
解析链接和图像引用上的 multimarkdown 样式键值属性。 这
扩展不应与 link_attributes 扩展混淆。
这是具有 multimarkdown 属性的参考 ![image][ref]。
[参考]： http://path.to/image “图片标题”宽=20px 高=30px
id=myId class="myClass1 myClass2"
扩展： mmd_header_identifiers
解析 multimarkdown 样式的标题标识符（在方括号中，在标题之后但
在 ATX 标头中的任何尾随 # 之前）。
扩展： 紧凑定义列表
激活 pandoc 1.12.x 及更早版本的定义列表语法。 这种语法不同
从几个方面的定义列表中描述的：
· 定义列表的连续项之间不需要空行。
· 要获得“紧密”或“紧凑”列表，请省略连续项之间的空格； 空间
术语与其定义之间没有任何影响。
· 不允许段落的惰性换行：整个定义必须缩进四
空格。
降价 变种
除了 pandoc 的扩展 Markdown 之外，还支持以下 Markdown 变体：
markdown_phpextra （PHP 降价 额外的）
脚注、pipe_tables、raw_html、markdown_attribute、fenced_code_blocks、
definition_lists、intraword_underscores、header_attributes、link_attributes、
缩写，shortcut_reference_links。
markdown_github （GitHub 风格的 降价）
管道表、raw_html、tex_math_single_backslash、fenced_code_blocks、
auto_identifiers、ascii_identifiers、backtick_code_blocks、autolink_bare_uris、
intraword_underscores，三振出局，hard_line_breaks，表情符号，
shortcut_reference_links。
markdown_mmd （多降价）
pipeline_tables raw_html、markdown_attribute、mmd_link_attributes、raw_tex、
tex_math_double_backslash、intraword_underscores、mmd_title_block、脚注、
definition_lists、all_symbols_escapable、implicit_header_references、
auto_identifiers、mmd_header_identifiers、shortcut_reference_links。
降价严格 （降价.pl）
原始html
扩展 - 格式 other 比 降价
上面讨论的一些扩展可以用于 Markdown 以外的格式：
· auto_identifiers 可用于 latex、rst、mediawiki 和纺织输入（并用于
默认）。
· tex_math_dollars, tex_math_single_backslash, 和 tex_math_double_backslash 都可以使用
带有 html 输入。 （这对于阅读使用 MathJax 格式化的网页非常方便，对于
例子。）
制作 投影片 SHOWS 与 潘多克
可以使用 pandoc 制作一个可以查看的 HTML + javascript 幻灯片演示
通过网络浏览器。 有五种方法可以做到这一点，使用 S5、DZSlides、Slidy、Slideous、
或reveal.js。 您还可以使用 LaTeX 投影仪制作 PDF 幻灯片。
这是一个简单幻灯片的 Markdown 源，惯用的.txt：
％ 习惯
% 约翰·多伊
% 22 年 2005 月 XNUMX 日
＃ 在早晨
＃＃ 起床
- 关闭闹钟
- 起床
＃＃ 早餐
- 吃鸡蛋
- 喝咖啡
＃ 晚上
＃＃ 晚餐
- 吃意大利面
- 喝红酒
------------------
＃＃ 去睡觉
- 上床
- 数羊
要生成 HTML/javascript 幻灯片，只需键入
pandoc -t 格式 -s 习惯.txt -o 习惯.html
其中 FORMAT 是 s5、slidy、slideous、dzslides 或revealjs。
对于 Slidy、Slideous、reveal.js 和 S5，pandoc 生成的文件带有
-s/--standalone 选项嵌入了一个指向 javascripts 和 CSS 文件的链接，这些文件被假定为
在相对路径 s5/default（对于 S5）、slideous（对于 Slideous）、reveal.js 中可用
（对于reveal.js），或者在Slidy 网站w3.org（对于Slidy）。 （这些路径可以
通过设置 slidy-url、slideous-url、revealjs-url 或 s5-url 变量进行更改； 看
上面的幻灯片变量。）对于 DZSlides，（相对较短的）javascript 和 css 是
默认包含在文件中。
对于所有 HTML 幻灯片格式，--self-contained 选项可用于生成单个
包含显示幻灯片所需的所有数据的文件，包括链接的
脚本、样式表、图像和视频。
要使用 beamer 制作 PDF 幻灯片，请键入
pandoc -t 投影机习惯.txt -o 习惯.pdf
请注意，reveal.js 幻灯片放映也可以通过将其打印到文件来转换为 PDF
从浏览器。
结构化 此 滑 显示
默认情况下， 滑 水平 是层次结构中最高的标题级别
立即按内容，而不是文档中某处的另一个标题。 在示例中
上面，级别 1 标题总是跟在级别 2 标题后面，然后是
内容，所以 2 是幻灯片级别。 可以使用 --slide-level 覆盖此默认值
选项。
文档按照以下规则分割成幻灯片：
· 水平线总是开始新的幻灯片。
· 幻灯片级别的标题总是开始一张新幻灯片。
· 标题 如下。 层次结构中的幻灯片级别创建标题 中 一张幻灯片。
· 标题 以上 层次结构中的幻灯片级别创建“标题幻灯片”，其中仅包含
部分标题并帮助将幻灯片放映分成多个部分。
· 标题页是根据文档的标题栏自动构建的（如果存在）。
（在 beamer 的情况下，这可以通过注释掉默认的一些行来禁用
模板。）
这些规则旨在支持多种不同风格的幻灯片放映。 如果你不
关心将幻灯片组织成节和小节，你可以只使用级别 1
每张幻灯片的标题。 （在这种情况下，级别 1 将是幻灯片级别。）但是您可以
还可以将幻灯片放映分成多个部分，如上例所示。
注意：在reveal.js幻灯片中，如果幻灯片级别为2，则为二维布局
生成，1 级标题水平构建，2 级标题构建
垂直。 不建议您使用更深的节级嵌套
揭示.js。
增加的 名单
默认情况下，这些编写器生成显示“一次全部”的列表。 如果你想要你的清单
要增量显示（一次一个项目），请使用 -i 选项。 如果你想要一个
与默认值不同的特定列表（即，在没有
-i 选项并同时使用 -i 选项），将其放在块引号中：
> - 吃意大利面
> - 喝葡萄酒
通过这种方式，增量和非增量列表可以混合在一个文档中。
插入 休息
您可以通过包含包含三个点的段落在幻灯片中添加“暂停”，
用空格隔开：
# 暂停滑动
暂停前的内容
。 。 。
暂停后的内容
造型 此 幻灯片
您可以通过将自定义的 CSS 文件放入其中来更改 HTML 幻灯片的样式
$DATADIR/s5/default（对于 S5）、$DATADIR/slidy（对于 Slidy）或 $DATADIR/slideous（对于
Slideous），其中 $DATADIR 是用户数据目录（参见上面的 --data-dir）。 这
原件可以在 pandoc 的系统数据目录中找到（通常
$CABALDIR/pandoc-VERSION/s5/default）。 Pandoc 会在那里寻找它没有的任何文件
在用户数据目录中找到。
对于 dzslides，CSS 包含在 HTML 文件本身中，并且可以在那里进行修改。
所有reveal.js 配置选项都可以通过变量设置。 例如，主题可以
通过设置主题变量来使用：
-V 主题=月亮
或者您可以使用 --css 选项指定自定义样式表。
要设置投影仪幻灯片的样式，您可以指定主题、颜色主题、字体主题、内部主题和
外主题，使用 -V 选项：
pandoc -t 投影机习惯.txt -V 主题：华沙 -o 习惯.pdf
请注意，标题属性将变成幻灯片属性（在或者） 在
HTML 幻灯片格式，允许您设置单个幻灯片的样式。 在 beamer 中，唯一的标题
影响幻灯片的属性是 allowframebreaks 类，它设置
allowframebreaks 选项，如果内容过满会导致创建多张幻灯片
框架。 特别推荐用于参考书目：
# 引用 {.allowframebreaks}
喇叭 笔记
Reveal.js 对演讲者笔记有很好的支持。 您可以在 Markdown 文档中添加注释
从而：
这是我的笔记。
- 它可以包含 Markdown
- 喜欢这个列表
要显示备注窗口，请在查看演示文稿时按 s。 笔记还没有
支持其他幻灯片格式，但注释不会出现在幻灯片本身上。
Frame 属性 in 投影仪
有时需要将 LaTeX [fragile] 选项添加到 beamer 中的框架（对于
例如，当使用 minted 环境时）。 这可以通过添加脆弱的
类到介绍幻灯片的标题：
# 脆弱的幻灯片 {.fragile}
Beamer 用户指南第 8.1 节中描述的所有其他帧属性可能
也可以使用：allowdisplaybreaks、allowframebreaks、b、c、t、环境、标签、普通、
收缩。
创作 电子发行版 与 潘多克
EPUB 元数据
可以使用 --epub-metadata 选项指定 EPUB 元数据，但如果源
文档是 Markdown，最好使用 YAML 元数据块。 下面是一个例子：
---
标题：
- 类型：主要
文字：我的书
- 类型：副标题
正文：元数据调查
创建者：
- 角色：作者
文字：约翰·史密斯
- 角色：编辑
文字：莎拉·琼斯
标识符：
- 方案：DOI
文字：doi:10.234234.234/33
出版商：我的出版社
权利：© 2007 约翰·史密斯，CC BY-NC
...
识别以下字段：
识别码
字符串值或具有文本和方案字段的对象。 有效值
方案是 ISBN-10, GTIN-13, UPC, ISMN-10, DOI, LCCN, GTIN-14, ISBN-13,
法定缴存号、URN、OCLC、ISMN-13、ISBN-A、JP、OLCC。
标题 一个字符串值，或者一个带有文件和类型字段的对象，或者一个这样的列表
对象。 类型的有效值为 main、subtitle、short、collection、 edition、
扩展。
创造者
字符串值，或具有角色、文件作为和文本字段的对象，或列表
这样的对象。 角色的有效值是 MARC 关系，但 pandoc 会尝试
将人类可读的版本（如“作者”和“编辑”）翻译成
适当的马克关系。
贡献者
与创建者的格式相同。
日期 YYYY-MM-DD 格式的字符串值。 （只需要年份。）Pandoc 将
尝试转换其他常见的日期格式。
郎 （或 遗产： 语）
BCP 47 格式的字符串值。 Pandoc 将默认为本地语言，如果
没有指定。
主题
字符串值或此类值的列表。
描述
一个字符串值。
类型 一个字符串值。
格式 一个字符串值。
关系
一个字符串值。
覆盖
一个字符串值。
权利 一个字符串值。
封面图片
一个字符串值（封面图片的路径）。
样式表
一个字符串值（CSS 样式表的路径）。
页面进度方向
无论是 ltr 还是 rtl。 指定页面进程方向属性
脊柱元素。
链接 上的相关利益产业。
默认情况下，pandoc 会下载链接的媒体（包括音频和视频）并包含它
在 EPUB 容器中，生成一个完全独立的 EPUB。 如果你想链接到
而是使用外部媒体资源，在源中使用原始 HTML 并将 data-external="1" 添加到
带有 src 属性的标签。 例如：
<来源src =“/http://example.com/music/toccata.mp3"
data-external="1" type="audio/mpeg">
识字 哈斯克尔 客户服务
如果将 +lhs（或 +literate_haskell）附加到适当的输入或输出格式
（markdown、markdown_strict、rst 或 latex 用于输入或输出；beamer、html 或 html5 用于
仅输出），pandoc 会将文档视为有文字的 Haskell 源。 这意味着
· 在 Markdown 输入中，"bird track" 部分将被解析为 Haskell 代码而不是
块引用。 \begin{code} 和 \end{code} 之间的文本也将被视为
哈斯克尔代码。 对于 ATX 样式的标头，将使用字符“=”而不是“#”。
· 在 Markdown 输出中，具有类 haskell 和 literate 的代码块将使用
鸟迹，块引用将缩进一个空格，因此它们不会
视为 Haskell 代码。 此外，标题将呈现 settext 样式（与
下划线）而不是 ATX 样式（带有“#”字符）。 （这是因为 ghc 对待
第 1 列中的“#”字符作为介绍行号。）
· 在重组文本输入中，“鸟迹”部分将被解析为 Haskell 代码。
· 在重构文本输出中，类haskell的代码块将使用bird来渲染
轨道。
· 在 LaTeX 输入中，代码环境中的文本将被解析为 Haskell 代码。
· 在 LaTeX 输出中，具有类 haskell 的代码块将在代码内部呈现
环境。
· 在 HTML 输出中，带有类 haskell 的代码块将与类一起呈现
literatehaskell 和鸟类足迹。
例子：
pandoc -f 降价+lhs -t html
读取用 Markdown 约定格式化的有文化的 Haskell 源代码并编写普通的 HTML
（没有鸟的踪迹）。
pandoc -f 降价+lhs -t html+lhs
在鸟类轨迹中使用 Haskell 代码编写 HTML，因此可以将其复制和粘贴为
识字的 Haskell 源代码。
句法 突出显示
Pandoc 将自动高亮标有标记的围栏代码块中的语法
语言名称。 Haskell 库 highlighting-kate 用于高亮显示，其中
适用于 HTML、Docx 和 LaTeX/PDF 输出。 可以使用
--highlight-style 选项。 默认的配色方案是 pygments，它模仿了
Python 库 pygments 使用的默认配色方案，但 pygments 实际上不是
用来做高亮。
要查看 pandoc 将识别的语言名称列表，请键入 pandoc --version。
要禁用突出显示，请使用 --no-highlight 选项。
定制 作家
Pandoc 可以使用 lua 编写的自定义编写器进行扩展。 （Pandoc 包括一个 lua
解释器，所以不需要单独安装lua。）
要使用自定义编写器，只需指定 lua 脚本的路径来代替输出
格式。 例如：
pandoc -t 数据/sample.lua
创建自定义编写器需要为每个可能的元素编写一个 lua 函数
pandoc 文档。 要获得记录的示例，您可以根据自己的情况进行修改
需要，做
pandoc --打印默认数据文件sample.lua
作者
© 2006-2015 约翰麦克法兰 ([电子邮件保护]）。 根据 GPL 版本 2 或
更大。 本软件不承担任何形式的保证。 （请参阅版权以获取完整
版权和保修声明。）
贡献者包括 Aaron Wolen、Albert Krewinkel、Alexander Kondratskiy、Alexander
苏弗瑞安、亚历山大·V·维希洛夫、阿尔弗雷德·韦赫塞尔伯格、安德烈亚斯·勒沃、安德鲁·邓宁、
Antoine Latter、Arata Mizuki、Arlo O'Keeffe、Artyom Kazak、Ben Gamari、Beni
切尔尼亚夫斯基-帕斯金、比约恩·巴克沃尔特、布拉德利·库恩、布伦特·约吉、布莱恩·奥沙利文、B.
斯科特·米歇尔、卡莱布·麦克丹尼尔、卡尔文·贝克、克里斯托弗·阿克尔曼、克里斯托弗·萨维奇、
克莱尔·麦克雷、克林特·亚当斯、康纳尔·埃利奥特、克雷格·S·博斯马、丹尼尔·伯吉、丹尼尔·T。
斯塔尔、大卫·拉扎尔、大卫·罗斯利斯伯格、丹尼斯·拉萨尔德、道格拉斯·卡尔弗特、道格拉斯 F.
卡尔弗特、埃里克·考、埃里克·塞德尔、弗洛里安·艾特尔、弗朗索瓦·甘纳兹、弗莱里克·巴拉尔、费奥多尔
谢列梅捷夫、加博·帕利、加文·比蒂、格雷格·马斯洛夫、格雷戈里·巴塔耶、格雷格·伦德莱特、
格温、格温·布兰温、汉斯-彼得·德费尔、亨利·德·瓦朗斯、伊利亚 V. 波特诺夫、infinity0x、
Jaime Marquínez Ferrándiz、James Aspnes、Jamie F. Olson、Jan Larres、Jason Ronallo、Jeff
阿诺德、杰夫·伦根、延斯·彼得森、杰瑞米·博比奥、杰西·罗森塔尔、J.刘易斯·缪尔、乔
希伦布兰德、约翰·麦克法兰、乔纳斯·斯梅德高、乔纳森·多尔蒂、约瑟夫·斯文宁森、
何塞·路易斯·杜兰、朱利安·克里特尔、贾斯汀·博格纳、凯尔西·海托尔、康斯坦丁·祖多夫、
拉尔斯-多米尼克·布劳恩、卢克·普兰特、马克·斯泽皮涅茨、马克·赖特、高桥正史、马泰
科拉尔、马蒂亚斯·申纳、马修·皮克林、马蒂亚斯·CM·特罗菲斯、毛罗·比格、马克斯
博林布鲁克、马克斯·赖达尔·安德森、梅里恩·维斯特拉滕、迈克尔·斯诺曼、迈克尔·汤普森、
MinRK、内森·加斯、尼尔·梅休、尼克·巴特、尼古拉斯·凯泽、尼古拉·亚基莫夫、恩卡尔维、保罗
谷本、保罗·里维尔、彼得·王、菲利普·奥姆布雷丹、菲利普·阿尔戴、普内斯·查甘蒂、
qerub、拉尔夫·斯蒂芬、Recai Oktaş、rodja.trappe、RyanGlScott、斯科特·莫里森、谢尔盖
Trofimovich、谢尔盖·阿斯塔宁、Shahbaz Youssefi、Shaun Attfield、shreevatsa.public、西蒙
Hengel、Sumit Sahrawat、takahashim、thsutton、Tim Lin、Timothy Humphries、Todd Sifleet、
Tom Leese、Uli Köhler、Václav Zeman、Viktor Kronvall、Vincent、Wikiwide 和 Xavier Olive。
Pandoc 源代码和所有文档可以从http://pandoc.org>.
使用 onworks.net 服务在线使用 pandoc
