1107 字
6 分钟
Markdown 基础语法
段落与换行
效果
这是第一行文本,行尾加两个空格
这是同一段落内的强制换行。
这是新段落,与上一段之间保留了空行。
源码(注意第一行行尾有 2 个空格)
这是第一行文本,行尾加两个空格这是同一段落内的强制换行。
这是新段落,与上一段之间保留了空行。行尾也可以用反斜线 \ 代替两个空格实现强制换行。
标题
效果
这是三级标题
这是四级标题
源码
# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题各级标题会自动生成语义锚点并进入右侧目录。
引用块
效果
这是第一层引用内容。
这是嵌套的第二层引用。
引用内部支持列表与格式化:
- 第一项说明
- 第二项说明
引用内的行内代码
源码
> 这是第一层引用内容。>> > 这是嵌套的第二层引用。>> 引用内部支持列表与格式化:> 1. 第一项说明> 2. 第二项说明>> `引用内的行内代码`列表
效果
- 无序列表项一
- 无序列表项二
- 缩进两个空格形成子列表
- 第二个子列表项
- 第一步操作
- 第二步操作
- 第三步操作
源码
- 无序列表项一- 无序列表项二 - 缩进两个空格形成子列表 - 第二个子列表项
1. 第一步操作2. 第二步操作3. 第三步操作无序列表的标记符号可以用 -、*、+,官方建议统一使用 -。
任务清单
效果
- 已完成的核心配置项
- 待编写的技术文档章节
- 待确认的排版细节
源码
- [x] 已完成的核心配置项- [ ] 待编写的技术文档章节- [ ] 待确认的排版细节代码块
效果
interface SiteConfig { title: string; themeColor: number;}源码(外层四反引号仅为包裹,实际写三个反引号)
```typescriptinterface SiteConfig { title: string; themeColor: number;}```除围栏写法外,正文缩进 4 个空格也会成为代码块。
水平分割线
效果
段落上部内容
段落下部内容
源码
段落上部内容
---
段落下部内容分割线用 3 个或更多 -、*、_ 都可以。
文本强调
效果
斜体文本、粗体文本、粗斜体文本、删除线文本、行内代码
源码
*斜体文本***粗体文本*****粗斜体文本***~~删除线文本~~`行内代码`链接
效果
自动链接:https://shirone.mysqil.com
源码
行内式:[链接文字](https://shirone.mysqil.com/ "可选的悬停提示标题")
参考式:详细规范请参考 [官方文档][docs] 和 [仓库地址][repo]。
自动链接:<https://shirone.mysqil.com>
[docs]: https://shirone.mysqil.com/ "文档站"[repo]: https://github.com/LyraVoid/Shirone "GitHub"图片
效果

源码
图片的宽度控制与图题排版在图片画廊与排版一篇里单独演示。
转义字符
效果
*这不是斜体文本*
[这不是链接]
# 这不是标题
源码
\*这不是斜体文本\*\[这不是链接\]\# 这不是标题可转义的保留符号包括:\、`、*、_、{}、[]、()、#、+、-、.、!。
原生 HTML
效果
使用 Ctrl + C 复制内容。
居中显示的纯 HTML 说明文本
源码
使用 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制内容。
<div style="text-align: center;"> 居中显示的纯 HTML 说明文本</div>编辑器快捷键
| 排版效果 | 语法格式 | 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 |
写作注意
- 段落之间需一个或更多空行分隔,标记符号与文本之间必须保留空格;
- 官方建议统一使用
-与 Atx 井号标题语法; - 转义只对保留符号加
\生效。
Markdown 基础语法
https://www.klucen.cn/posts/syntax/markdown-basic/分享文章
生成精美分享图或复制链接,与更多人分享本文。
继续阅读
换条路线
从其他文章中稳定抽取
最后更新于 ,距今已过 301 天
部分内容可能已过时
评论