在Github中使用Quarto渲染Markdown

Question

6

我使用（新的）RStudio quarto引擎创建了一个markdown文件。我想将`.md`文件上传到Github仓库，但是一些元素无法正确呈现。例如，很多表格无法呈现，一些markdown代码会直接呈现出来（例如:::{.column-page}）。

这是我第一次使用quarto。如果我想要创建一个尽可能与Github markdown引擎兼容的r markdown文件，我应该怎么做（我不需要坚持使用quarto）？

- Thomas Speidel

2个回答

2

您可以查看GitHub的文档，了解其Markdown引擎支持的语法，基本写作和格式语法，虽然它涵盖了许多场景，但不支持像您提到的RStudio Quarto这样的引擎。

另一个选择是使用GitHub Pages，在那里您可以使用诸如Jekyll和一些自定义插件来生成静态站点，以生成静态站点并上传它。

我不知道RStudio Quarto的具体插件，但我想您应该能够找到一个支持它的静态站点生成器工具。希望这有所帮助！

- Troy Poulter

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- tarleb · Accepted Answer

您可以使用Quarto将输入转换为GitHub Flavored Markdown(gfm)，方法是使用：

format: gfm

输出应该可以同时在Quarto和GitHub上使用。

另请参阅关于gfm的Quarto文档。