引言

本博客基于 Hugo + PaperMod 主题,使用了 Goldmark 渲染器,支持完整的 GFM(GitHub Flavored Markdown)规范,并允许在 Markdown 中直接嵌入 HTML 标签。

下面逐一展示所有格式,你可以对照查看渲染效果。

1. 标题

1
2
3
4

# H1 一级标题
## H2 二级标题
### H3 三级标题
#### H4 四级标题

2. 文本格式

普通文字,加粗文字,斜体文字,粗斜体,删除线,行内 代码。

引用块。Hugo 完整支持 GFM 引用,可以嵌套使用。

这是嵌套引用。

3. 列表

无序列表:

• 三维建模
  • BIM 建模
  • 传统 CG
• 数字孪生
• 虚拟仿真

有序列表:

1. 需求分析
2. 数据采集
3. 资产生产
4. 集成测试
5. 交付验收

任务列表(勾选框):

• 完成 BIM 建模
• 现场航拍
• 完成渲染
• 客户验收

4. 链接与图片

普通链接:Hugo 官网

图片:

5. 表格

6. 代码块(带高亮)

Python:

1
2
3
4
5
6

def hugo_build(site_path: str) -> int:
    """构建 Hugo 站点,返回耗时(毫秒)"""
    import time
    start = time.perf_counter()
    subprocess.run(["hugo", "--minify"], cwd=site_path, check=True)
    return int((time.perf_counter() - start) * 1000)

Go:

1
2
3
4
5
6
7

package main

import "fmt"

func main() {
    fmt.Println("Hello, Hugo!")
}

Bash:

1

hugo server -D --bind 0.0.0.0 --port 1313

YAML/TOML:

1
2
3
4

title: "船舶工程博客"
theme: "PaperMod"
params:
  defaultTheme: "auto"

7. 脚注

Hugo 支持脚注引用¹和多脚注²。

8. 定义列表

Hugo

一个用 Go 编写的静态站点生成器

PaperMod

一个为 Hugo 设计的高质量、响应式主题

GFM

GitHub Flavored Markdown,GitHub 扩展的 Markdown 规范

9. 数学公式

行内公式:爱因斯坦的质能方程 $E = mc^2$ 是物理学最著名的公式之一。

独立公式:

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

矩阵示例:

$$ \begin{bmatrix} a & b \ c & d \end{bmatrix} \begin{bmatrix} x \ y \end{bmatrix}

\begin{bmatrix} ax + by \ cx + dy \end{bmatrix} $$

10. 原始 HTML 嵌入

由于开启了 unsafe = true,所有 HTML 标签都可以直接用:

视频与 iframe

11. 分隔线

12. 键盘按键

按 Ctrl + C 复制,按 Ctrl + V 粘贴。

13. 上标与下标

水的化学式:H₂O 勾股定理:c² = a² + b²

✅ 以上就是本博客支持的所有格式。 如果你看到上面的代码块、表格、数学公式、HTML 折叠块、任务列表、脚注、定义列表全部正常显示,说明博客已经配置完成。