Markdown是一种轻量级标记语言,语法简洁易学,适合快速编写文档。本站采用的就是Markdown编辑器,支持通用Markdown语法和GMF语法。
通用Markdown语法指原始的、标准化的Markdown规范,基于CommonMark等规范定义,强调简洁性和可移植性。
它支持基本内容结构,如标题、列表、链接、代码块和引用,但功能相对基础,例如标题使用井号(#)表示等级,列表通过破折号或数字创建,代码块需缩进或使用反引号。这种语法设计较为通用,可在大多数Markdown渲染器中运行,适合简单文档和跨平台内容共享。
GFM语法(GitHub Flavored Markdown)是Markdown在GitHub平台上的扩展版本,基于CommonMark但增加了实用特性。
本教程涵盖核心语法,帮助你快速上手。
标题与段落
标题的语法是通过在行首添加 # 号和一个空格创建,# 的数量对应标题级别(1-6级),越往后,字号越小。如:
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
段落直接输入文本,段落间空一行以作分隔。
文本格式化
支持基本样式调整,包括:
加粗:用两个 * 或 _ 包围文本,如:**加粗文字**,效果:加粗文字。
斜体:用一个 * 或 _ 包围文本,如:*斜体文字*,效果:斜体文字。
删除线:用两个 ~ 包围文本,如:~~删除线~~,效果:删除线。
列表:
无序列表使用 -、+ 或 * 开头,后跟一个空格加具体内容。如:- 无序列表,效果:
- 无序列表
- 无序列表
有序列表用数字加点(如1.)开头,后跟一个空格加具体内容。如:1. 有序列表,效果:
- 第一章
- 第一节
- 第二节
- 第二章
- 第三节
- 第四节
任务列表用数字加点(如1.)开头,后跟一个空格加[ ],再跟着一个空格及具体内容。注意:中括号中间有一个空格,如:1. [ ] 任务一,1. [x] 任务二,效果:
- 任务一
- 任务二
嵌套列表通过缩进(4个空格)实现;
引用块以 > 开头,后加空格和文本。如:
这是一段引用。
链接: 语法为 [显示文本](URL)。
图片: 语法为 。
代码块: 使用三个反引号包裹实现。如:
```js
var txt;
txt = 'hello!';
```
效果:
var txt;
txt = 'hello!';
行内代码: 用反引号包裹,如:`sudo apt install gimp`,效果:sudo apt install gimp。
表格: 表格由表头、分隔线和数据行组成,用管道符|分隔列,分隔线需至少3个连字符,换行可通过段落空行、行尾两个空格或<br>标签实现,特殊符号需转义(如\*显示星号)。
如:
| 标题1 | 标题2 | 标题3 |
|---|---|---|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
皖公网安备34130202000765号