Jekyll构建Markdown标题显示异常，GitHub解析正常，求成因

云原生阿岚

2026-5-22

Markdown格式规范指南

这里有一份实用的Markdown格式规范，帮你快速搞定各种内容排版：

标题：用井号 # 定义标题层级，1个井号对应一级标题，最多支持6级，示例：
```
# 一级标题
## 二级标题
### 三级标题
```
列表项：所有列表项以短横线 - 开头，还能嵌套多层列表，示例：
```
- 外层列表项1
  - 内层嵌套列表项
- 外层列表项2
```
文本强调：用星号 * 包裹文本实现强调，单星号对应斜体，双星号对应粗体，示例：
```
*这是斜体文本*
**这是粗体文本**
```
代码/命令：单行代码或命令用单个反引号 ` 包裹，多行代码用三个反引号包裹（还可指定语言高亮），示例：
单行：
```
`python main.py`
```
多行：
```
function greet() {
  console.log("Hello World!");
}
```
引用文本：用大于号 > 标记引用内容，支持多层嵌套，示例：
```
> 这是一段基础引用
>> 这是嵌套在里面的引用内容
```
链接：遵循 [显示文本](链接地址) 的格式，点击显示文本即可跳转，示例：
```
[Markdown语法参考](https://example.com/markdown-guide)
```
图片：格式为 [图片替代文本](图片URL)，替代文本会在图片加载失败时显示，示例：
```
[风景图](https://example.com/landscape.jpg)
```