二甲基

1. 段落与换行#

• 段落：由连续文本行组成，段落之间通过一个或多个空行分隔。
• 强制换行：在行尾添加两个或以上空格后回车，或者在行尾使用反斜线 \ 后回车。

1
这是第一行文本，行尾加两个空格
2
这是同一段落内的强制换行。
3

4
这是新段落，与上一段之间保留了空行。

渲染效果：

这是第一行文本，行尾加两个空格
这是同一段落内的强制换行。

这是新段落，与上一段之间保留了空行。

2. 标题#

推荐使用标准的 Atx 井号语法，支持 1 到 6 级标题：

1
# 一级标题
2
## 二级标题
3
### 三级标题
4
#### 四级标题
5
##### 五级标题
6
###### 六级标题

构建阶段会自动为各级标题生成语义锚点，并自动提取到文章右侧的目录导航中。

渲染效果（文章顶部的一级标题由主题接管，正文中从二级开始使用）：

3. 引用块#

在行首使用 > 符号声明引用，支持多层嵌套以及在引用内部嵌入列表、代码和标题：

1
> 这是第一层引用内容。
2
>
3
> > 这是嵌套的第二层引用。
4
>
5
> 引用内部支持列表与格式化：
6
> 1. 第一项说明
7
> 2. 第二项说明
8
>
9
> `引用内的行内代码`

渲染效果：

这是第一层引用内容。

这是嵌套的第二层引用。

引用内部支持列表与格式化：

1. 第一项说明
2. 第二项说明

引用内的行内代码

4. 列表与任务清单#

1
- 无序列表项一
2
- 无序列表项二
3
  - 缩进两个空格形成子列表
4
  - 第二个子列表项

1
1. 第一步操作
2
2. 第二步操作
3
3. 第三步操作

1
- [x] 已完成的核心配置项
2
- [ ] 待编写的技术文档章节
3
- [ ] 待确认的排版细节

5. 代码块#

使用三个反引号包裹多行代码，并在首行声明编程语言：

1
```typescript
2
interface SiteConfig {
3
  title: string;
4
  themeColor: number;
5
}
6
```

渲染效果：

1
interface SiteConfig {
2
  title: string;
3
  themeColor: number;
4
}

6. 水平分割线#

单独成行使用三个或以上的 -、* 或 _ 创建分割线：

1
段落上部内容
2

3
---
4

5
段落下部内容

渲染效果：

段落上部内容

段落下部内容

1. 文本强调#

1
*斜体文本*
2
**粗体文本**
3
***粗斜体文本***
4
~~删除线文本~~
5
`行内代码`

渲染效果：斜体文本、粗体文本、粗斜体文本、删除线文本、行内代码

2. 超链接#

1
[链接文字](https://shirone.mysqil.com/ "可选的悬停提示标题")
2
[站内相对路径](/guide/intro/)

1
详细规范请参考 [官方文档][docs] 和 [仓库地址][repo]。
2

3
[docs]: https://shirone.mysqil.com/ "文档站"
4
[repo]: https://github.com/LyraVoid/Shirone "GitHub"

3. 图片插入#

语法与超链接类似，只需在最前方添加感叹号 !：

1
![图片替代文本](./scene-2.webp "可选图题")

图片与 index.md 放在同一个文章文件夹中，使用相对路径引用即可，构建期会自动压缩为 WebP 并生成响应式 srcset。

渲染效果：

4. 自动链接#

使用尖括号包裹网址或邮箱，系统会自动转换为可点击链接：

1
<https://shirone.mysqil.com>
2
<contact@example.com>

渲染效果：https://shirone.mysqil.com、contact@example.com

1. 转义字符#

当需要直接输出 Markdown 保留符号时，在符号前添加反斜线 \ 进行转义：

1
\*这不是斜体文本\*
2
\[这不是链接\]
3
\# 这不是标题

渲染效果：*这不是斜体文本*、[这不是链接]、# 这不是标题

可转义的字符包括：\、`、*、_、{}、[]、()、#、+、-、.、!。

2. 原生 HTML 支持#

Markdown 允许直接内嵌标准 HTML 标签（如 <kbd>、<span>、<details>）：

1
使用 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制内容。
2

3
<div style="text-align: center;">
4
  居中显示的纯 HTML 说明文本
5
</div>

渲染效果：使用 Ctrl + C 复制内容。

3. 编辑器快捷键对照#