使用 knitr 从 rmarkdown 生成.md 文档。有没有办法获得 atx 样式的标题而不是 Settext 样式的标题？

Question

我在 RStudio 中使用 Knit 从 RMarkdown 获取一个 .md 文档。

YAML 标头：

---
output:
  md_document
---

目标是获取可以在 GitHub 中作为 web 页面查看的.md 文档。

我遇到的问题是我以 atx 样式编写的标头：

# Header example

# 1. Header example

以 Settext 样式呈现：

Header example
==============

1. Header example
=================

为什么这是个问题？ 似乎 GitHub 查看器的 .md 文档在第一个字符是数字时显示这些 Setext 样式标题的方式与在它是字母时不同。

当标题为 atx 样式时，两者（编号和非编号）都以相同的格式显示。

有没有办法从 rmarkdown 以 atx 样式呈现这些标头？

我知道我可以编写一个脚本来修改 resultant.md 文档，但我想知道是否有最简单的方法。

Answer 1

编辑 2021/01/03

从pandoc 。 2.11.2+，ATX-headers 成为默认值。 请参阅手册页和新闻（ rmarkdown在GitHub上的问题也可能有帮助）。 因此，您不必公开指定 ATX 标头。

您仍然可以显式设置 ATX-header 选项，然后，您需要使用"--markdown-headings=atx" ，而不是不推荐使用的方法--atx-headers

如果你想获取带有 ATX-headers 的 md 文件，只需在 pandoc_args 中添加“ pandoc_args "--markdown-headings=atx"选项。

output:
  md_document:
    pandoc_args: [
      "--markdown-headings=atx"
    ]

Answer 2

我找到了为我解决它的方法。

当 Github 查看器发现：

Header 示例

==================

它不会将其显示为 header，而是如下所示：

Header 示例 =================

仅当数字后跟一个点时才会发生这种情况。 如果我们在数字前写其他任何内容：

.1。 Header 示例

==================

或在数字之后：

1- Header 示例

==================

它显示为 header。

我最终在文档中所做的是更改所有开头有数字的标题，方法是在数字后面添加一个连字符，如上例所示。