影响特定 writer 的选项

--self-contained[=true|false]

已弃用，与 —embed-resources —standalone 为同义。

--embed-resources[=true|false]

生成一个独立的 HTML 文件，不依赖外部资源，使用 data: URIs 将链接的脚本、样式表、图像和视频的内容合并进来。生成的文件应该是“自包含”的，即它不需要外部文件和网络访问，就可以由浏览器正确显示。此选项仅适用于 HTML 输出格式，包括 html4、html5、html+lhs、html5+lhs、s5、slidy、slideous、dzslides 和 revealjs。将下载绝对 URL 的脚本、图像和样式表；对于相对 URL 的资源，将相对于工作目录（如果第一个源文件是本地的）或相对于基本 URL（如果第一个源文件是远程的）进行搜索。带有属性 data-external=”1” 的元素将保持不变；它们链接到的文档将不会合并到文档中。限制：通过 JavaScript 动态加载的资源无法合并；因此，在使用 —mathjax 时可能会缺少字体，并且在离线“自包含”reveal.js幻灯片演示中，一些高级功能（例如缩放或演讲者说明）可能无法正常工作。

--html-q-tags[=true|false]

在 HTML 中使用 标签表示引用。 （仅当对所使用的输入格式启用 smart 扩展时，此选项才有效。）

--ascii[=true|false]

在输出中仅使用 ASCII 字符。目前支持 XML 和 HTML 格式（在选择此选项时使用实体而不是 UTF-8），CommonMark、gfm 和 Markdown（使用实体），roff man 和 ms（使用十六进制转义），以及在有限程度上的 LaTeX（尽可能使用带有重音字符的标准命令）。

--reference-links[=true|false]

在编写 Markdown 或 reStructuredText 时使用引用样式的链接，而不是内联链接。默认情况下使用内联链接。链接引用的放置位置受 —reference-location 选项的影响。

--reference-location=block|section|document

指定脚注（以及如果设置了 reference-links 则为引用）放置在当前（顶级）块、当前节还是文档的末尾。默认为文档。目前此选项仅影响 markdown、muse、html、epub、slidy、s5、slideous、dzslides 和 revealjs 作者。在幻灯片格式中，指定 —reference-location=section 将导致注释呈现在幻灯片底部。

--markdown-headings=setext|atx

指定在 Markdown 输出中对于级别 1 和 2 的标题使用 ATX 样式（# 前缀）或 Setext 样式（下划线下划线）。 （默认为 atx。）ATX 样式标题始终用于级别 3+。此选项还影响 ipynb 输出中的 Markdown 单元格。

--list-tables[=true|false]

在 RST 输出中将表格呈现为列表表格。

--top-level-division=default|section|chapter|part

在 LaTeX、ConTeXt、DocBook 和 TEI 输出中将顶级标题视为给定的分区类型。分层顺序为 part、chapter、然后是 section；所有标题都会移动，以使顶级标题变为指定的类型。默认行为是通过启发式确定最佳分区类型：除非其他条件适用，否则选择 section。当 documentclass 变量设置为 report、book 或 memoir 时（除非指定了 article 选项），将暗示 chapter 作为此选项的设置。如果输出格式是 beamer，则指定 chapter 或 part 将使顶级标题变为 \part{..}，而二级标题保持为其默认类型。

-N, --number-sections

在 LaTeX、ConTeXt、HTML、Docx、ms 或 EPUB 输出中为节标题编号。默认情况下，节是不编号的。具有 class unnumbered 的节永远不会编号，即使指定了 —number-sections。

--number-offset=NUMBER[,NUMBER,…]

在 HTML 输出中为节标题指定偏移量（在其他输出格式中被忽略）。第一个数字被添加到顶级标题的节号，第二个数字被添加到第二级标题，依此类推。例如，如果您希望文档中的第一个顶级标题编号为“6”，请指定 —number-offset=5。如果您的文档以级别-2的标题开头，希望其编号为“1.5”，请指定 —number-offset=1,4。默认情况下，偏移量为0。暗示 —number-sections。

--listings[=true|false]

对 LaTeX 代码块使用 listings 宏包。该宏包不支持源代码的多字节编码。要处理 UTF-8，您需要使用自定义模板。此问题在此文档中有详细说明：listings 宏包的编码问题。

-i, --incremental[=true|false]

使幻灯片演示中的列表项逐个显示（一个接一个）。默认情况下，列表会一次性显示出来。

--slide-level=NUMBER

指定具有指定级别的标题创建幻灯片（用于 beamer、s5、slidy、slideous、dzslides）。层次结构中此级别以上的标题用于将幻灯片演示分成部分；此级别以下的标题在幻灯片内创建子标题。有效值为 0-6。如果指定幻灯片级别为 0，则不会自动根据标题拆分幻灯片，必须使用水平线指示幻灯片边界。如果未显式指定幻灯片级别，则将根据文档的内容自动设置幻灯片级别；请参阅幻灯片演示的结构。

--section-divs[=true|false]

在