最近两三个月断断续续折腾着一个本来几乎被废弃的 R 包，就是 markdown 包；现在挖老坟挖到了尾声，可以吼一嗓子求公测了。这个包是本厂十一年前推出的第一代 R Markdown 的基础，后来没过多久就被第二代的 rmarkdown 包取代了，两个包的主要区别是 markdown 基于一个 C 语言库来转换 Markdown，所以不需要调用外部工具，而 rmarkdown 基于外部命令行工具 Pandoc。rmarkdown 以及它周围的生态系统已经相当丰富甚至繁杂，去年出道的 Quarto 更是高屋建瓴，大大扩展了 R Markdown 的疆域，功能更加强大和丰富。这让我开始有点怀疑人生，因为说实话，开发维护 R Markdown 的这些年让我还是感到有点疲惫的，我能理解层出不穷的“新功能”会让开发者和用户都感到兴奋，但我有点越来越兴奋不起来了。此处先略去三千字不表。总之呢，这两年在我脑子里萦绕的一个问题是，有没有可能写一个精简版的 Markdown 转换工具、声明它有限的功能之后就不用再费力开发新功能了。就在刚刚，我觉得我自己想要的功能已经基本完成、可以交卷，有兴趣的群众可以测试： install.packages('markdown', repos = c('https://rstudio.r-universe.dev', 'https://cloud.r-project.org')) # 确认一下版本 packageVersion('markdown') >= '1.5.5' 这个包主要支持 HTML 和 LaTeX 输出格式，用 markdown::mark_html() 和 markdown::mark_latex() 即可转换 Markdown 为 HTML 和 LaTeX。普通用户可能用不到这两个底层函数，我估计更多人熟悉 R Markdown 文档，那么在 YAML 中设置输出格式 output 为 markdown::html_format 或 markdown::latex_format 即可用 RStudio 的 Knit 按钮编译文档。因为这是精简版的 Markdown，所以很可能不会满足大多数人的需要，但最基础的 Markdown 语法都支持。具体支持哪些 Markdown 功能，请参见文档： vignette('intro', package = 'markdown') 牺牲掉一些功能换来的是编译速度会更快、生成文件体积更小。HTML 输出的 CSS 是纯手工写的，只有五六十行（1.3 K）。相比之下，rmarkdown 以及 Quarto 构建在 Bootstrap 框架上，空文档生成的 HTML 文件也会有七八百 K，比较笨重。因为去年偶然了解到一项有趣又简单的 CSS 技术，这次我也顺手写了一个精简版的 HTML 幻灯片框架（手工打造 CSS + JS）。两个月前我拿它小试牛刀作了个报告，最近继续打磨了一下，现在也可以拉出来见人了（尤其想请 Windows/Linux 用户报告一下体验，因为我全程在苹果系统上开发和测试的）： vignette('slides', package = 'markdown') 我觉得我个人作报告时需要的功能已经集齐了。我用了六年谢轮眼（xaringan），估计接下来在这个新款幻灯片下应该能待十年了吧。精简的好处之一就是，只要不满意，就可以直接从底层掀翻修改（CSS/JS），而不需要考虑一堆依赖。尽管为了保持轻盈，我不计划再大幅增加新的 Markdown 功能，但要是各位觉得有什么重要或常用的 Markdown 语法在当前的实现中缺失，请尽管提建议。我自己基本上只剩一项大功能想加上了，就是 ::: 层。语法层面的功能我不会过多考虑，不过我还会继续写一些轻量级 JS/CSS 代码实现别的功能（诸如浮动目录、侧栏脚注等）。重要的事情再重复一遍：这个包功能有限，只提供一箪食一瓢饮（在很多细微的设计里算是蕴含了我十年经验吧），很可能不会是你想要的，建议多数人出门右转找 Quarto ，那样应该会更省心。

俺看明白了，占个座先，晚上回去试试。举个手，俺迷路了。我打开Rstudio，下载了包，确认了版本，接着 File-->New File-->Markdown File 新建了一个.md文档。没找到 Knit 那个毛线球按钮，只看见一个 Preview，点了以后在Render 窗格报了个错： Error in (function (meta = NULL, template = NULL, options = NULL, keep_md = FALSE, : rmarkdown version >= 2.18 required. Calls: <Anonymous> -> create_output_format -> do.call -> <Anonymous> 停止执行那个.md文档全部内容如下： --- title: test output: markdown::html_format: meta: css: [default, slides] # "slides" is an alias of "snap.css" js: [slides] # "slides" is an alias of "snap.js" --- ## First slide Content. ## Second slide Content. ## Third slide ## ✿✿ヽ(°▽°)ノ✿ 环境信息如下： R version 4.2.1 (2022-06-23 ucrt) Platform: x86_64-w64-mingw32/x64 (64-bit) Running under: Windows 10 x64 (build 19045) Matrix products: default locale: [1] LC_COLLATE=Chinese (Simplified)_China.utf8 LC_CTYPE=Chinese (Simplified)_China.utf8 [3] LC_MONETARY=Chinese (Simplified)_China.utf8 LC_NUMERIC=C [5] LC_TIME=Chinese (Simplified)_China.utf8 attached base packages: [1] stats graphics grDevices utils datasets methods base loaded via a namespace (and not attached): [1] compiler_4.2.1 fastmap_1.1.0 cli_3.4.1 markdown_1.5.7 htmltools_0.5.3 tools_4.2.1 rstudioapi_0.14 [8] yaml_2.3.6 rmarkdown_2.17 data.table_1.14.4 knitr_1.40 xfun_0.37 digest_0.6.30 rlang_1.0.6 [15] evaluate_0.17

看来语法用的是 GitHub Flavored Markdown，输出格式是 HTML 和 LaTex。

CyrusYip 是的。其实 GFM 有些槽点，我觉得有些糟糕，比如单双波浪线都是删除线的语法，而单波浪线是 Pandoc 的下标语法，所以我在包中去掉了单波浪线的删除线功能，与 Pandoc 保持统一。Github 上支持数学公式，但 GFM 并不支持，这也有点闹心，我得自己实现。与 Pandoc 保持一致的好处是可以用 RStudio 的可视化 Markdown 编辑器，写起 Markdown 来比较舒服。

油管上挖出来了报告的视频。这下 markdown、rmarkdown 和 Quarto 覆盖了各种需求的人群。

在 mac os 试了下，发现幻灯片少于等于3页生成的网页不是幻灯片格式，也没有页码，多于3页就正常了，这是默认幻灯片都多于3页的隐藏设定吗？

yufree 是的，暂时是这样设定的。我感觉实际应用中应该不大可能只有 3 页幻灯片，不过这样设定确实会造成初始的困惑，我再考虑一下，至少得在文档中写一下这个设定。

yihui 我想到一个可能只有 3 页幻灯片的使用场景，比如会议的某个分论坛主持人做开场介绍，第一页宣传页，第二页和第三页是演讲嘉宾的安排、标题和简介。

Cloud2016 最后加一页充数的 Thank you! 或者 Questions? 或者 Fin ，完美解决 😂

yufree Cloud2016 已经取消这个页数限制。重新安装开发版本即可。就算只有一页幻灯片应该也可以正确生成出来了。谢谢。

yuanfan 执行下面这个会出来，不会报错，看来只是不应该点 Preview。 markdown::mark_html("test.md", output = "test.html", meta = list( css = c("default", "slides"), js = "slides"))

精简版的 R Markdown（求测试）

yihui

最近两周增加了以下新功能：

::: 层，HTML 输出 <div>，LaTeX 输出 \begin...\end... 环境。能用层之后 Markdown 就可以做很多额外的事情了。
自包含（self-contained）HTML 文件的支持大大增强。九年前我向 Pandoc 建议提供一个选项，让 Pandoc 可以不要嵌入网络资源、只嵌入本地文件。当时作者没有采纳，但前几年他提供了一个蹩脚的办法，就是在网络资源的标签中加入 data-external="1" 的属性，这样 Pandoc 就可以不下载、嵌入它。如今我抄起键盘把这个功能在 markdown 包中实现了。当创建自包含 HTML 文件时，可选嵌入本地或网络文件或二者皆嵌入（参见文档中的 embed_resources 选项）。
增强了 MathJax 支持，并新加了 KaTeX 支持。后者基本上可以本嵌入进自包含的 HTML 输出中，也就意味着离线也可以渲染数学公式。前者因为实在是太复杂了，目前只能部分嵌入。
增强了高亮工具 highlight.js 的支持，并新加了另一个高亮工具 Prism.js 的支持。后者我已经听说几年，但如今终于有动力研究了一下，因为我觉得 highlight.js 的基础库还是太臃肿，自带的三十多种语言里多数都是我不需要的（除了演示，谁会在一个页面上使用三十多种语言呢）。Prism 提供了一个只有几 K 的核心库，然后按需加载需要的语言支持，这一点正好符合我的需求。于是 markdown 的默认高亮工具变成了 Prism。

这下应该是没什么大的核心功能可加了。其它边边角角的功能估计我会用插件形式去做。

chuxinyuan

R Markdown 里输入中文经常会莫名其妙的换行，其实上一行还可以写好几个字的，不知道它为什么要换行呢，我不知道这个问题是不是只有我遇到了。

yihui

chuxinyuan 请提供一个如此莫名其妙的例子吧，如果没有可重复的例子，那么是很难猜的。

chuxinyuan

yihui 是的，这里给出一个可重复的例子会更好点。只是每个人的 RStudio 设置的不一样……

---
title: "测试用例"
output: html_document
---

```{r}
#| echo: FALSE
abcdefghijklmn = 1
```


&emsp;&emsp;当圆的半径为`r abcdefghijklmn[1]`时，圆的面积为`r pi * abcdefghijklmn * abcdefghijklmn`，圆的周长周长为`r 2 * pi * abcdefghijklmn`；当圆的半径为`r abcdefghijklmn[1]`时，圆的面积为`r pi * abcdefghijklmn * abcdefghijklmn`，圆的周长周长为`r 2 * pi * abcdefghijklmn`；当圆的半径为`r abcdefghijklmn[1]`时，圆的面积为`r pi * abcdefghijklmn * abcdefghijklmn`，圆的周长周长为`r 2 * pi * abcdefghijklmn`；当圆的半径为`r abcdefghijklmn[1]`时，圆的面积为`r pi * abcdefghijklmn * abcdefghijklmn`，圆的周长周长为`r 2 * pi * abcdefghijklmn`；当圆的半径为`r abcdefghijklmn[1]`时，圆的面积为`r pi * abcdefghijklmn * abcdefghijklmn`，圆的周长周长为`r 2 * pi * abcdefghijklmn`；当圆的半径为`r abcdefghijklmn[1]`时，圆的面积为`r pi * abcdefghijklmn * abcdefghijklmn`，圆的周长周长为`r 2 * pi * abcdefghijklmn`；当圆的半径为`r abcdefghijklmn[1]`时，圆的面积为`r pi * abcdefghijklmn * abcdefghijklmn`，圆的周长周长为`r 2 * pi * abcdefghijklmn`；当圆的半径为`r abcdefghijklmn[1]`时，圆的面积为`r pi * abcdefghijklmn * abcdefghijklmn`，圆的周长周长为`r 2 * pi * abcdefghijklmn`；当圆的半径为`r abcdefghijklmn[1]`时，圆的面积为`r pi * abcdefghijklmn * abcdefghijklmn`，圆的周长周长为`r 2 * pi * abcdefghijklmn`；

编辑器会出现莫名其妙换行。

yihui

chuxinyuan 这个问题与本帖无关。简言之，编辑器的换行行为通常是以西文习惯为准的，也就是逢空格才考虑换行，这样做是为了避免分裂一个完整的单词。中文不以空格为分隔符，所以连续的中文字符会被当做一个“单词”。要是你觉得实在辣眼睛，不妨切换到 RStudio 的可视化编辑器。

chuxinyuan

yihui 如此看来，是编辑器的问题。问题不大，对编织的文档结果没影响就行，谢谢答疑解惑。

dapengde

yihui

我能理解层出不穷的“新功能”会让开发者和用户都感到兴奋，但我有点越来越兴奋不起来了。

是不是属于审美疲劳？三年前我偶然看见一个有趣的工具，就在它基础上写了一个跟 R Markdown 有关的包，很另类，自用了一年，就是一直提不起精神来把它公开……

yihui

dapengde 审美疲劳是一方面。另一方面是维护起来太累了，这跟生娃太像了，生之前往往体会不到原来生下来之后要费这么大劲去养。现在体会到了无穷尽的新功能要花那么多时间和精力去维护，我压根儿就不想去把它们开发出来了，因为那些破功能都特么太占用我养娃的时间和精力……

刚刚把新一版的 markdown 包发上了 CRAN：https://cran.r-project.org/package=markdown 宣布主要功能已经集结完毕，接下来应该不会有大动作了。最近主要花时间写了几篇文档，敲键盘敲得现在我小指都酸了。

入门（或入坑）介绍：https://cran.r-project.org/package=markdown/vignettes/intro.html
幻灯片的花式玩法：https://cran.r-project.org/package=markdown/vignettes/slides.html
文章样式：https://cran.r-project.org/package=markdown/vignettes/article.html

我记得你大前年好像问过（若不是你就是湘云，我记不清了）是不是可以把 hugo-prose 的样式搬进 R Markdown，当时我说可以考虑。这两天我也挑灯夜战把里面的 CSS 和 JS 抽离出来，可以复用了。上面的第三篇文档就是一个演示，还用我的黄瓜架子当了超宽图片的例子。这一阵高强度脑力劳动结束，明天我也要去园子里翻地种菜了。这边的春天终于来了。

dapengde

yihui

是的，生出来不易，养起来更难。短痛能忍，长痛难熬。我现在是写个包也不想发布，以前发布的从CRAN下架了也懒得去修改升级。常常怀疑做了是为了啥，不做又能怎么样。大概是老了。

很高兴看的 prose 主题可以独立使用，这个需求我肯定提过，但忘了是在哪里提的了。

« 上一页