这篇既是我们发布内容时的速查表, 也是排版的试金石。写完新文章后可以对照检查一下渲染效果。

标题与强调

用 # 到 ###### 表示一至六级标题。行内可以写 加粗、斜体、删除线 和 行内代码。

列表

无序列表:

  • 第一项
  • 第二项
    • 嵌套一项

有序列表:

  1. 先写草稿
  2. 本地预览一遍
  3. 确认无误再发布

链接与图片

链接: Hugo 官方文档

图片(把文件放到 static/images/ 后这样引用):

![示意图](/images/example.png)

引用

把复杂的想法写清楚, 是思考的一部分, 不是思考之后的额外工作。

—— 某位不知名的程序员

代码块

带上语言名即可获得语法高亮, 右上角还有一键复制按钮。

def fibonacci(n: int) -> list[int]:
    seq = [0, 1]
    while len(seq) < n:
        seq.append(seq[-1] + seq[-2])
    return seq[:n]


print(fibonacci(10))

hugo server --port 8090     # 本地预览
hugo new content posts/新文章.md
hugo --minify               # 生成可部署的 public/

表格

命令作用常用参数
hugo new新建内容content/posts/x.md
hugo server本地预览--port 8090 --buildDrafts
hugo生成静态站点--minify

提示块

主题支持 alert 短代码:

提示
这是一个提示块, 适合放补充说明。
注意
这是警告块, 适合放需要小心的地方。

目录

在文章开头(front matter)加上 showToc: true, 页面就会出现目录; 再加 tocopen: true 则默认展开 —— 就像本文这样。

数学公式

配置里已经开启 passthrough, 行内公式 $E = mc^2$ 与块级公式都能直接写:

$$ \int_{-\infty}^{\infty} e^{-x^2}\,\mathrm{d}x = \sqrt{\pi} $$

总结

以上基本覆盖了日常写作会用到的语法。剩下的, 交给内容本身。