如何使用 pandoc 将目录添加到 R Markdown HTML 文件？答案

【问题标题】：How to add table of contents to R Markdown HTML file using pandoc?如何使用 pandoc 将目录添加到 R Markdown HTML 文件？
【发布时间】：2012-06-14 06:00:26
【问题描述】：

如何使用 pandoc 向 R Markdown HTML 文件添加目录但保留所有 HTML 格式和标题信息？

例如，如果我有一个名为 test.html 的文件，我会尝试：

pandoc -s -S --toc test.html -o test-toc.html

这会添加目录，但会删除现有的标题信息，这使得所有格式都具有吸引力。

因此，它使this html file 看起来像this one。我想保留格式。

【问题讨论】：

标签： r knitr pandoc

【解决方案1】：

我不确定如何告诉 Pandoc 保留所有样式和标题信息。但是，想必这种风格并没有太大的变化，所以你为什么不把它复制到一个.css 样式表文件中，并在生成输出HTML 时指向这个文件（使用-c 或--css 命令行选项） ?您可以使用--self-contained 命令行选项告诉 Pandoc 将此样式表信息嵌入到您的最终输出中（有关选项的完整列表，请参阅here）。

对于输入 HTML 文件中的 MathJax 脚本，您可以使用

--mathjax=https://c328740.ssl.cf1.rackcdn.com/mathjax/2.0-latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML

最后，你可以使用 R 语法荧光笔

--include-in-header=r_syntax.html

其中r_syntax.html 包含包装在<script> 标记中的适当JavaScript。

更新： 说了这么多，您可以将所有样式和脚本信息包含在一个文件中（例如r_styling.html），并将其包含在输出 HTML 标题的末尾，使用

pandoc -s -S --toc -h r_styling.html --self-contained test.html -o test-toc.html

-h 选项是--include-in-header 的简写。

【讨论】：