基础语法
约 1052 字大约 4 分钟
2026-08-31
Markdown 是一种轻量级标记语言，通过简洁直观的标记语法让纯文本具备格式化排版能力。Shirone 原生支持完整的 CommonMark 与 GFM 规范。
一、块级元素
1. 段落与换行
- 段落：由连续文本行组成。段落之间通过一个或多个空行进行分隔。
- 强制换行：在行尾添加两个或以上空格后回车，或者在行尾使用反斜线
\后回车。
这是第一行文本，行尾加两个空格
这是同一段落内的强制换行。
这是新段落，与上一段之间保留了空行。2. 标题
推荐使用标准的 Atx 井号语法，支持 1 到 6 级标题：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题构建阶段会自动为各级标题生成语义锚点，并自动提取到文章右侧的目录导航中。
3. 引用块
在行首使用 > 符号声明引用，支持多层嵌套以及在引用内部嵌入列表、代码和标题：
> 这是第一层引用内容。
>
> > 这是嵌套的第二层引用。
>
> 引用内部支持列表与格式化：
> 1. 第一项说明
> 2. 第二项说明
>
> `引用内的行内代码`4. 列表与任务清单
无序列表
使用 -、* 或 + 开头（推荐统一使用 -），标记符号与文本之间必须保留空格：
- 无序列表项一
- 无序列表项二
- 缩进两个空格形成子列表
- 第二个子列表项有序列表
使用数字加英文句点 1. 开头：
1. 第一步操作
2. 第二步操作
3. 第三步操作任务清单
使用方括号标注任务状态：
- [x] 已完成的核心配置项
- [ ] 待编写的技术文档章节
- [ ] 待确认的排版细节5. 代码块
使用三个反引号包裹多行代码，并在首行声明编程语言：
```typescript
interface SiteConfig {
title: string;
themeColor: number;
}
```6. 水平分割线
单独成行使用三个或以上的 -、* 或 _ 创建分割线：
段落上部内容
---
段落下部内容二、行内元素
1. 文本强调
*斜体文本*
**粗体文本**
***粗斜体文本***
~~删除线文本~~
`行内代码`2. 超链接
行内式链接
[链接文字](https://shirone.mysqil.com/ "可选的悬停提示标题")
[站内相对路径](/guide/intro/)参考式链接
适合在长文中多次引用同一地址：
详细规范请参考 [官方文档][docs] 和 [仓库地址][repo]。
[docs]: https://shirone.mysqil.com/ "文档站"
[repo]: https://github.com/LyraVoid/Shirone "GitHub"3. 图片插入
语法与超链接类似，只需在最前方添加感叹号 !：
4. 自动链接
使用尖括号包裹网址或邮箱，系统会自动转换为可点击链接：
<https://shirone.mysqil.com>
<contact@example.com>三、常用辅助与转义
1. 转义字符
当需要直接输出 Markdown 保留符号时，在符号前添加反斜线 \ 进行转义：
\*这不是斜体文本\*
\[这不是链接\]
\# 这不是标题可转义的字符包括：\、`、*、_、{}、[]、()、#、+、-、.、!。
2. 原生 HTML 支持
Markdown 允许直接内嵌标准 HTML 标签（如 <kbd>、<span>、<details>）：
使用 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制内容。
<div style="text-align: center;">
居中显示的纯 HTML 说明文本
</div>3. 编辑器快捷键对照
| 排版效果 | 语法格式 | Windows / Linux 快捷键 | macOS 快捷键 |
|---|---|---|---|
| 粗体 | **文本** | Ctrl + B | Command + B |
| 斜体 | *文本* | Ctrl + I | Command + I |
| 行内代码 | `代码` | Ctrl + Shift + ` | Command + Shift + ` |
| 插入链接 | [文本](链接) | Ctrl + K | Command + K |
| 插入图片 |  | Ctrl + Shift + I | Command + Shift + I |
四、排版建议与最佳实践
- 中文排版间距：中文字符与英文字符、数字之间建议保留一个半角空格，提升可读性。
- 标点规范：中文句子中使用全角中文标点，英文句子与代码中严格使用半角标点。
- 图片格式：推荐优先使用 WebP 或 AVIF 格式图片，兼顾画质与加载速度。