将 Bookdown 编译成 Markdown?

Compile Bookdown to Markdown?

有什么方法可以获取 Bookdown 项目,并将其构建为 Markdown 而不是 HTML 或 TeX?

我问是因为我需要 post 处理 Bookdown 的最终 Markdown 输出,以便提取 R 和 Python 笔记本以供下载。

更详细地说,我正在使用 Bookdown 构建一个嵌入笔记本下载的教科书,其中笔记本包含 bookdown .Rmd 文件中的代码和文本的子集。例如,一章可以包含多个笔记本。

为了做到这一点,我在 RMarkdown 输入文本中放置了开始和结束注释标记以标识将成为笔记本的部分,然后 post- 处理生成的 Markdown 文件以提取笔记本部分。比如:

<!--- notebook: first_section.Rmd
-->

Some explanation, maybe using Bookdown extra markup such as @a_citation.

```{r}
a <- 1
a
```

<!--- end of notebook
-->

More markdown.

```{r}
# More code not in notebook.
b <- 2
```

显然我可以使用输入的 RMarkdown 页面,但这会很丑陋,因为所有扩展的 Bookdown 标记(例如引用、交叉引用等)都会以原始和丑陋的形式出现在生成的笔记本中。所以我真的很想能够在合并、解决引用和交叉引用之后获得最终输出 Markdown。有什么办法吗?

我的问题类似于this as-yet unanswered question,但增加了我对这个问题的官方解决方案的动力。

在CRAN上使用最新版本的bookdown,您可以使用输出格式bookdown::markdown_document2,例如

output: 
  bookdown::markdown_document2:
    base_format: rmarkdown::md_document
    variant: gfm