Mobile wallpaper 1Mobile wallpaper 2Mobile wallpaper 3Mobile wallpaper 4Mobile wallpaper 5Mobile wallpaper 6
4511 字
23 分钟
markdown综合教程

目录#

基础部分#

进阶部分#


一.标题语法#

“#” + 空格 + 标题名称,一个“#”表示一级标题,以此类推,一、二级标题有使用若干“=”,“-”分割的特殊表示方法

代码示例:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
一级标题
=======
二级标题
-------

效果预览:

一级标题#

二级标题#

三级标题#

四级标题#

五级标题#
六级标题#

一级标题#

二级标题#


二.段落语法#

要分割段落,只需要在两个段落之间添加空白行即可

代码示例:

我喜欢你,
你喜欢我吗
我不喜欢你,
我们还是算了吧

效果预览:

我喜欢你, 你喜欢我吗

我不喜欢你, 我们还是算了吧


三.markdown换行语法#

1.空格换行#

在内容末尾敲击至少两个空格,在回车,即可换行

代码示例:

有你在的今天
今天本是平凡的一天
却成为了还不错的一天

效果预览:
有你在的今天
今天本是平凡的一天
却成为了还不错的一天

2.标签换行#

在内容末尾添加<br>标签即可

代码示例:

虽然没有什么特别的事<br>
但只要有你在就足够了<br>

效果预览:
虽然没有什么特别的事
但只要有你在就足够了

四.强调语法#

1.粗体#

(1).星号加粗#

在文字两端都添加两个星号* 代码示例:

**直到现在**

效果预览:
直到现在

(2).下划线加粗#

在文字两端都添加两个下划线_

代码示例:

__你依然是我的光__

效果预览:
你依然是我的光

:要在中间部分加粗最好使用星号

2.斜体#

(1).星号#

在文字两端都添加一个星号*
代码示例:

*你啊*

效果预览: 你啊

(2).下划线#

在文字两端都添加一个下划线_
代码示例:

_在不知不觉中已经成为了我每天的日常了_

效果预览: 在不知不觉中已经成为了我每天的日常了

3.同时使用#

可以有很多种组合方式,效果都是一样的

代码示例:

***和你说话时***
_**和你说话时**_
*_和你说话时__*

效果预览:
和你说话时

.在中间使用强调语法强调一律使用星号

五.引用语法#

1.块引用#

> + 空格 + 引用内容 代码示例:

> 总觉得每天都会变得开心一点

效果预览:

总觉得每天都会变得开心一点

2.多个段落的块引用#

在段落之间的空白行添加>即可

代码示例:

> hello world
>
> say hello

效果预览:

hello world

say hello

3.嵌套块引用#

引用也是可以嵌套的

代码示例:

> 这是一个引用
>
>>这是引用中的引用
>>
>>>这是引用中的引用中的引用

效果预览:

这是一个引用

这是引用中的引用

这是引用中的引用中的引用

4.带有其他元素的块引用#

部分语法不支持,请自行尝试

代码示例:

> # 一级标题
> **粗体**
> _斜体_
> - 无序列表

效果预览:

一级标题#

粗体
斜体

  • 无序列表

六.列表语法#

1.有序列表#

n. + 空格 + 内容
列表也支持嵌套

每日计划#

代码示例:

1. 吃饭
1. 吃早饭
2. 吃午饭
3. 吃晚饭
2. 睡觉
1. 早上睡
2. 中午睡
3. 晚上睡
1. 做个好梦
2. 做个噩梦

效果预览:

  1. 吃饭
    1. 吃早饭
    2. 吃午饭
    3. 吃晚饭
  2. 睡觉
    1. 早上睡
    2. 中午睡
    3. 晚上睡
      1. 做个好梦
      2. 做个噩梦

2.无序列表#

代码示例:

# 1.加号
+ 学习C语言
+ 数据类型
+ 常量变量
+ 作用域
+ 操作符
# 2.减号
- 背1000个单词
- 500个四级单词
- 500个六级单词
- 以a开头的单词
# 3.星号
* 跑1000m路程

效果预览:

  • 学习C语言
    • 数据类型
    • 常量变量
    • 作用域
    • 操作符
  • 背1000个单词
  • 500个四级单词
  • 500个六级单词
    • 以a开头的单词
  • 跑1000m路程

:列表中同样可以使用其他语法格式

七.代码语法#

可以将自己写的代码放进代码块中,这样更加美观

1.反引号#

代码示例:

`print(hello world)`

效果预览:
print(hello world)

2.转义反引号#

需要在代码块里面写出反引号,要在外部额外添加反引号

代码示例:

``print(`hello world`)``

效果预览:
print(`hello world`)

3.代码块#

(1).缩进式代码块#

给所写的代码每一行添加四个空格
代码示例:

#include <stdio.h>
int main()
{
print(hello world);
return 0;
}

效果预览:

#include <stdio.h>
int main()
{
print(hello world);
return 0;
}

(2).反引号代码块#

代码示例: 在代码上下使用首尾呼应的三反引号```,在第一个部分可添加代码语言名称,用来显示高亮的代码

```py
print(hello world)
**效果预览:**
```py
print(hello world)

(3).波浪号代码块#

使用三波浪号~~~,与反引号同理 代码示例:

~~~python
print(hello world)
~~~

效果预览:

print(hello world)

八.分割线语法#

使用三个及以上的星号(***).破折号(---).或下划线(___)

代码示例:

***
---
___

效果预览:




:为了兼容性,请在分割线前后均添加空白行

九.链接语法#

链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。

1.无title#

代码示例:

[仙鹤的学习小窝](http://47.108.140.232)

效果预览:
仙鹤的学习小窝

2.有title#

代码示例:

[仙鹤的学习小窝](http://47.108.140.232 "坚持学习,无限进步")

效果预览:
仙鹤的学习小窝

3.尖括号链接#

使用尖括号可以很方便地把URL或者email地址变成可点击的链接

代码示例:

<http://47.108.140.232/>
<xkl51920@gmail.com>

效果预览:
http://47.108.140.232/
xkl51920@gmail.com

4. 带格式化的链接#

(1).强调链接, 在链接语法前后增加星号#

代码示例:

**[仙鹤的学习小窝](http://47.108.140.232)**

效果预览:
仙鹤的学习小窝

(2)要将链接表示为代码,请在方括号中添加反引号#

代码示例:

[`仙鹤的学习小窝`](http://47.108.140.232)

效果预览:
仙鹤的学习小窝

5. 引用链接#

分为两部分

代码示例:

[仙鹤的学习小窝][1]
[1]: http://47.108.140.232 "坚持学习,无限进步"

效果预览:
仙鹤的学习小窝

(1).第一部分#

尽管不是必需的,可以在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写,可以包含字母,数字,空格或标点符号。

(2).第二部分#

引用类型链接的第二部分使用以下属性设置格式:

  1. 放在括号中的标签,其后紧跟一个冒号和至少一个空格(例如[label]:)。
  2. 链接的URL,可以选择将其括在尖括号中。
  3. 链接的可选标题,可以将其括在双引号,单引号或括号中。

:第二部分的上一行不能有任何内容

[1]: http://47.108.140.232
[1]: http://47.108.140.232 "坚持学习,无限进步"
[1]: http://47.108.140.232 '坚持学习,无限进步'
[1]: http://47.108.140.232 (坚持学习,无限进步)
[1]: <http://47.108.140.232> "坚持学习,无限进步"
[1]: <http://47.108.140.232> '坚持学习,无限进步'
[1]: <http://47.108.140.232> (坚持学习,无限进步)

链接最佳实践

不同的 Markdown 应用程序处理URL中间的空格方式不一样。
为了兼容性,请尽量使用%20代替空格。
[仙鹤的学习小窝](http://%2047.108.140.232%20)

十.图片语法#

1.基本图片语法#

要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。

代码示例:

![一只可爱的特莉波卡](小波卡.jpg)

效果预览:
一只可爱的特莉波卡

2.链接图片语法#

给图片增加链接,请将图像的Markdown括在方括号中,然后将链接添加在圆括号中。

代码示例:

[![特莉波卡-冬日](https://image.emoera.cn:443/uploads/ubpY6WS-s3X8.webp)](https://image.emoera.cn:443/uploads/ubpY6WS-s3X8.webp)

效果预览:
特莉波卡-冬日

来自E时代图床

十一.转义字符语法#

1.基本的转义语法#

要显示原本用于格式化Markdown文档的字符,请在字符前面添加反斜杠字符 \ 。

代码示例:

\`E时代是CDTU最强算法开发社团\`

效果预览:
`E时代是CDTU最强算法开发社团`

2.可做转义的字符#

代码示例:

\
\`
\*
\_
\{\}
\[\]
\()
\#
\+
\-
\.
\!
\|

效果预览:
\ ` * _ {} [] () # + - . ! |

一.表格#

1.基础表格#

要添加表,请使用三个或多个连字符(---)创建每列的标题,并使用管道(|)分隔每列。您可以选择在表的任一端添加管道

代码示例:

| 类型关键字 | 中文名称 | 字节大小 |
|-------|------|------|
| char | 字符型 | 1 |
| int | 整型 | 4 |

效果预览:

类型关键字中文名称字节大小
char字符型1
int整型4

2.表格对齐#

您可以通过在标题行中的连字符的左侧,右侧或两侧添加冒号(:),将列中的文本对齐到左侧,右侧或中心

代码示例:

| 类型关键字 | 中文名称 | 字节大小 |
|:------|:----:|-----:|
| short | 短整型 | 2 |
| long | 长整型 | 4/8 |

效果预览:

类型关键字中文名称字节大小
short短整型2
long长整型4/8

3.格式化表格中的文字#

您可以在表格中设置文本格式。例如,您可以添加链接,代码(仅反引号(`)中的单词或短语,而不是代码块)和强调。

您不能添加标题,块引用,列表,水平规则,图像或HTML标签。

表格中的格式化#

代码示例:

| 可以使用 | 不可以使用 |
|-------|--------|
| 添加链接 | 添加标题 |
| 反引号代码 | 代码块 |
| 强调 | 标题 |
| | 块引用 |
| | 列表 |
| | 水平规则 |
| | 图像 |
| | HTML标签 |

效果预览:

可以使用不可以使用
添加链接添加标题
反引号代码代码块
强调标题
块引用
列表
水平规则
图像
HTML标签

4.在表中转义管道字符#

您可以使用表格的HTML字符代码(|),或者使用反斜杠(\)转义的方式,在表中显示竖线(|)字符.

代码示例:

| 表头 |
|:------:|
| \| |
| &#124; |

效果预览:

表头
|
|

二.围栏代码块#

1.反引号代码块#

代码示例:

```c
#include <stdio.h>
int main()
{
int a = 0;
int b = 0;
a = 10; /*给a赋值
b = 20; 给b赋值*/
printf("a+b=%d\n", a + b);
return 0;
}
```

效果预览:

#include <stdio.h>
int main()
{
int a = 0;
int b = 0;
a = 10; /*给a赋值
b = 20; 给b赋值*/
printf("a+b=%d\n", a + b);
return 0;
}

2.波浪号代码块#

代码示例:

~~~c
#include <stdio.h>
int main()
{
int a = 0;
int b = 0;
a = 10; /*给a赋值*/
b = 20; /*给b赋值*/
printf("a+b=%d\n", a + b);
return 0;
}
~~~

效果预览:

#include <stdio.h>
int main()
{
int a = 0;
int b = 0;
a = 10; /*给a赋值*/
b = 20; /*给b赋值*/
printf("a+b=%d\n", a + b);
return 0;
}

3.语法高亮#

要添加语法突出显示,请在受防护的代码块之前的反引号旁边指定一种语言

代码示例:

```python
print("hello world")
```
```json
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}
```

效果预览:

print("hello world")
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}

三.脚注#

代码示例:

这是一个脚注[^1],用来解释内容
[^1]: 这是一个解释,用来解释脚注标记的内容

效果预览:
这是一个脚注1,用来解释内容


有的编辑器可能不支持脚注,会将其识别为链接

四.标题编号 {#标题一}#

第一部分:在标题后面添加空格和中括号,并且在中括号填写地址名称

第二部分:在中括号填写展示的文本,在小括号填写地址,即可通过点击文字进行跳转

代码示例:

# 四.标题编号 {#标题一}
[四.标题编号](#标题一)

效果预览:
四.标题编号

:有的编辑器可能不支持这种扩展格式,而是这样的

代码示例:

# 四.标题编号
[点击跳转到语法综合文档](#markdown教程)

效果预览:

点击跳转到语法综合文档

五.定义列表#

包括术语和定义两部分#

核心用途#

  1. 整理术语表(如技术文档中的概念解释)
  2. 编写FAQ回答(问题 = 术语,答案 = 定义)
  3. 说明功能/参数(功能名称 = 术语,用法 = 定义)
  4. 替代表格的简单”两列结构”,排版更简洁

示例#

代码示例:

Markdown
: 一种轻量级标记语言,用于快速编写格式化文档,语法简洁易记。
Typora
: 一款支持实时预览的 Markdown 编辑器,
支持定义列表.表格.公式等扩展语法,
排版美观且操作直观。
锚点跳转
: 通过 `[链接文字](#ID)` 语法,实现页面内快速跳转的功能,
常用于长文档的目录导航。

效果预览:

Markdown : 一种轻量级标记语言,用于快速编写格式化文档,语法简洁易记。

Typora : 一款支持实时预览的 Markdown 编辑器,
支持定义列表.表格.公式等扩展语法,
排版美观且操作直观。

锚点跳转 : 通过 [链接文字](#ID) 语法,实现页面内快速跳转的功能,
常用于长文档的目录导航。

六.删除线#

您可以通过在单词中心放置一条水平线来删除单词。结果看起来像这样。此功能使您可以指示某些单词是一个错误,要从文档中删除。若要删除单词,请在单词前后使用两个波浪号~~。

代码示例:

~~世界是平坦的。~~ 我们现在知道世界是圆的。

效果预览:
世界是平坦的。 我们现在知道世界是圆的。

七.任务列表#

代码示例:

未完成:- [ ] 内容 中括号填写空格
已完成:- [×] 内容 中括号填写小写“x

## 今日计划
- [ ] 吃饭
- [ ] 睡觉
- [x] 做作业

效果预览:

今日计划#

  • 吃饭
  • 睡觉
  • 做作业

八.使用Emoji表情#

1.复制粘贴表情符号#

在大多数情况下,您可以简单地从Emojipedia (opens new window)等来源复制表情符号并将其粘贴到文档中。许多Markdown应用程序会自动以Markdown格式的文本显示表情符号。从Markdown应用程序导出的HTML和PDF文件应显示表情符号。

Tip: 如果您使用的是静态网站生成器,请确保将HTML页面编码为UTF-8。

Emoji表情

2.使用表情符号简码#

一些Markdown应用程序允许您通过键入表情符号短代码来插入表情符号。这些以冒号开头和结尾,并包含表情符号的名称

代码示例:

:tent:
:joy:

效果预览:
:tent:
:joy:

九.自动网址链接#

许多Markdown处理器会自动将URL转换为链接。这意味着如果您输入http://47.108.140.232/,即使您未使用方括号,您的Markdown处理器也会自动将其转换为链接

代码示例:

http://47.108.140.232

效果预览:
http://47.108.140.232

禁用自动网址链接#

通过反引号代码来解决

代码示例:

`http://47.108.140.232/`

效果预览:
http://47.108.140.232/

变通教程#

下划线#

Markdown 原生不支持下划线,但如果你的 Markdown 处理器支持 HTML,可以使用 <ins> 标签:

代码示例:

一些文字 <ins>将被加下划线</ins>。

效果预览:
一些文字 将被加下划线

缩进#

Markdown里的空格和制表符有特殊用途,比如创建换行或代码块。如果你想用Tab缩进段落,可以使用&nbsp;

代码示例:

&nbsp;&nbsp;&nbsp;&nbsp;这是一个缩进的段落。

效果预览:
    这是一个缩进的段落。

文字居中#

Markdown 没有文本对齐的语法,但可以使用 HTML 标签 <center>(已废弃)或 CSS 解决:

代码示例:

<p style="text-align:center">这段文字居中显示。</p>

效果预览:

这段文字居中显示。

文字颜色#

Markdown 不支持更改文字颜色,但 HTML 可以:

代码示例:

<font color="red">这段文字是红色的!</font>
<p style="color:blue">这段文字是蓝色的。</p>

效果预览:
这段文字是红色的!

这段文字是蓝色的。

Footnotes#

  1. 这是一个解释,用来解释脚注标记的内容

markdown综合教程
http://47.108.140.232/posts/markdown_guide/
作者
仙鹤
发布于
2025-12-29
许可协议
CC BY-NC-SA 4.0

部分信息可能已经过时

封面
Sample Song
Sample Artist
封面
Sample Song
Sample Artist
0:00 / 0:00