格式调整

有些同学的 Markdown 语法不规范,导致解析时出错。这里将常见的问题列出来,供大家参考。

标题不正确

在 Markdown 中,标题是以 # 开头的,# 的数量表示标题的级别。例如:

# 一级标题
## 二级标题
### 三级标题

# 和标题文本之间一定要有一个空格,否则会被当作普通文本。

如下面的例子:

### 正确的标题
###错误的标题

正确的标题

###错误的标题

换行不正确

在 Markdown 中,换行是需要有两个以上的换行符才会生效的。例如:

第一行
第二行

在显示的时候,不会换行:

第一行 第二行

而要换行,需要这样:

第一行

第二行

这样就会换行:

第一行

第二行

添加网页标题

在 Quarto 中,网页的标题由 YAML 头部的 title 字段或者 # 标题决定。这里,我们使用 # 标题作为网页的标题。

给每个页面添加一个 # 标题,这样就可以在导航栏中看到了。

library("stringr")

files = list.files(path = ".", pattern = "group[0-9]{2}.md", full.names = TRUE)
for (file in files) {
  lines = readLines(file)
  group = str_extract(file, "[0-9]{2}") |> as.numeric()
  head = paste0("# Group ", group, "\n\n")
  if (is.na(lines[1]) | lines[1] != head){
    lines = c(head, lines)
    writeLines(lines, file)
  }
}