01-Markdown特性完整测试

本文用于一次性冒烟：标准 Markdown、GFM 扩展、代码块（含高亮行）、Mermaid fence、数学公式，以及本站常用的 Solitude shortcode。改主题或自定义 CSS 后，打开本页扫一眼即可。

1. 标题层级

下面从 ## 到 ######（页面标题已占用 h1）。

1.1 三级标题 H3

1.1.1 四级标题 H4

五级标题 H5

六级标题 H6

2. 段落与行内强调

普通段落。同一段内可以混排粗体、斜体、粗斜体、~~删除线~~，以及 行内代码。

还可以组合：** 里不该再套代码；正确写法是 bold with code 或 italic with code。

硬换行（行尾两个空格）会变成
下一行（同一段落内的强制换行）。

软换行（单个换行）在 Markdown 里通常仍并成同一段。

3. 链接与图片

3.1 链接

行内链接：撷时录首页
带标题的链接：Hugo
自动链接：https://jiangbyte.github.io/
参考式链接：Solitude 主题

站内锚点：跳到表格 · 跳到 Mermaid

3.2 图片

标准 Markdown 图片（远程）：

主题静态资源：

行内小图：Solitude logo。

带说明的块级图：

4. 列表

4.1 无序列表

苹果
香蕉
- 芭蕉（嵌套）
- 皇帝蕉
樱桃

4.2 有序列表

先判断是不是 bundle
不是 bundle，而且图片路径是相对路径——就用 .Page.File.Dir 拼绝对路径
试着找一下图片资源，找不到就直接用绝对路径当 src

长文换行悬挂缩进测试：Leaf page 没有图片优化。Page bundle 的图片会被主题做 responsive resize（生成多尺寸 + srcset），leaf page 的图不会。如果对图片体积有要求，还是推荐 bundle。

4.3 任务列表（GFM）

写完厨房水槽文
同步 / 构建不报错
人工肉眼过一遍暗色模式
确认移动端 TOC 可读

4.4 混排

有序第一项
- 无序子项 A
- 无序子项 B
有序第二项
1. 有序子项 2.1
2. 有序子项 2.2

5. 引用

一级引用：分层是为了改需求时知道改哪一层。
二级引用：依赖只能向内，不要让基础设施倒灌领域。
回到一级。引用里也可以有粗体和 code。

6. 分隔线

上一段。

下一段（中间是 ---）。

再一段（中间是 ***）。

7. 代码

7.1 行内

安装：hugo version，配置键：params.solitude.theme_color。

7.2 围栏代码（无高亮语言）

plain fence
line two

plain fence
line two

7.3 带语言

1package main
2
3import "fmt"
4
5func main() {
6	fmt.Println("hello solitude")
7}

package main

import "fmt"

func main() {
	fmt.Println("hello solitude")
}

1params:
2  solitude:
3    mermaid: true
4    katex:
5      enable: true

params:
  solitude:
    mermaid: true
    katex:
      enable: true

1hugo server --bind 127.0.0.1 --port 1313

hugo server --bind 127.0.0.1 --port 1313

7.4 高亮行（Chroma `hl_lines`）

1package demo
2
3func Add(a, b int) int {
4	return a + b
5}
6
7func main() {}

package demo

func Add(a, b int) int {
	return a + b
}

func main() {}

1<img src="/posts/assets/example.jpg" alt="leaf">
2<!-- 期待：路径按 File.Dir 纠正 -->

<img src="/posts/assets/example.jpg" alt="leaf">
<!-- 期待：路径按 File.Dir 纠正 -->

8. 表格

对齐	左对齐	居中	右对齐
文本	foo	bar	12
代码	`a`	`b`	34
强调	粗	斜	删

宽表横向滚动检查：

维度	Page Bundle	Leaf Page + render hook	备注
图片优化	responsive + srcset	原图直出	bundle 更适合大图
改造成本	每篇建目录	配置一次	leaf 存量友好
路径稳定性	相对路径自然	绝对路径兜底	深层 permalink 必测

9. 脚注

这里引用一个脚注¹，再引用同一个¹，以及另一个²。

10. HTML（`unsafe: true`）

原生 details / summary

里面可以继续写 Markdown 风格段落，但作为 HTML 块时以渲染器行为为准。

键盘：Ctrl + K · 高亮：mark 文本 · 上标 H₂O / E=mc²

缩写：DDD

11. Mermaid

11.1 Fence（```mermaid）

flowchart TB interfaces[interfaces 用户接口] application[application 应用] domain[domain 领域] infrastructure[infrastructure 基础设施] interfaces --> application application --> domain infrastructure --> domain

sequenceDiagram participant C as Controller participant A as Application participant D as Domain C->>A: command A->>D: domain call D-->>A: result A-->>C: view/DTO

11.2 Shortcode

flowchart LR Markdown --> Hugo Hugo --> HTML HTML --> Browser

12. 数学公式（KaTeX）

行内：勾股定理 $a^2 + b^2 = c^2$，以及质能 $E = mc^2$。

块级：

\[ \int_{-\infty}^{\infty} e^{-x^2}\,dx = \sqrt{\pi} \]$$ \begin{aligned} \nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\ \nabla \cdot \mathbf{B} &= 0 \end{aligned} $$

13. Solitude Shortcode：文本与状态

蓝色段落提示：用于较强的段落级强调。

正文里的红色重点与普通文字并列。

已完成信息注意扩展危险

已完成事项

尚未完成

已选中

未选中

快捷键 ⌘ K · 剧透答案在这里气泡left

14. 折叠 / 隐藏 / 标签页

折叠面板（默认收起）

折叠内支持 Markdown 与 code。

折叠面板（默认展开）

默认展开，方便检查焦点与间距。

行内隐藏：答案是。

1fmt.Println("tab: go")

fmt.Println("tab: go")

1theme: solitude

theme: solitude

标签页用于并排对比配置或代码。

15. 按钮、链接卡、内容卡

Hugo 官网描边按钮整行按钮

引用站外链接

Hugo

The world’s fastest framework for building websites

站内链接

返回首页，检查触控与焦点

纯内容

无封面卡片简洁层级，不依赖本地 demo 封面。

封面

有封面卡片使用主题默认图作封面。

16. 时间线

规划定分层与用例边界。

实现竖切用户注册 / 登录。

回归打开本页做 Markdown 冒烟。

17. 图表与动态文字

{"type":"line","data":{"labels":["一","二","三"],"datasets":[{"label":"构建次数","data":[2,5,3],"borderColor":"#4f4a45","backgroundColor":"rgba(79,74,69,0.15)"}]},"options":{"plugins":{"legend":{"display":true}},"scales":{"y":{"beginAtZero":true}}}}

三期构建趋势

TypeIt：用于检查动态文字与主题色是否协调。

18. 仓库卡

GitHub

hugo

正在读取仓库信息…

——

加载中