使用 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。

我最終在文檔中所做的是更改所有開頭有數字的標題，方法是在數字后面添加一個連字符，如上例所示。