Markdown 语法
史博辉 2022-10-12 14:11:00 markdown
# 标题
- 使用 = 和 - 标记一级和二级标题。
一级标题
========
二级标题
--------
效果如下:
- 使用 # ,可表示1-6级标题。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果如下:
# 段落
段落的前后要有空行,所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。
- 段落的前后空行(回车)
段落一
段落二
效果如下:
段落一
段落二
- 段内强制换行(两个空格)
段落一
段落二
效果如下:
段落一
段落二
# 区块引用
在段落的每行或者只在第一行使用符号>,还可使用多个嵌套引用,如:
> 区块引用
>> 嵌套引用
>>> 嵌套的嵌套引用
效果如下:
区块引用
嵌套引用
嵌套的嵌套引用
# 代码区块
插入程序代码的方式有两种:使用反引号 `(~ 键)、使用缩进(Tab)。
- 插入行内代码,即插入一个单词或者一句代码的情况,使用
code
这样的形式插入。 - 插入多行代码,分别使用三个反引号(```)包裹多行代码。或者使用缩进。
- 行内代码
在一般的段落文字中,可以使用反引号 ` 来标记或插入代码区段。
C语言里的函数 `scanf()` 怎么使用?
效果如下:
C语言里的函数 scanf()
怎么使用?
当然也可以标记 文件名
、关键词
等。
- 多行代码
- 在需要高亮的代码块的前一行及后一行使用三个反引号 ```(~ 键)
- 同时第一行反引号后面,输入代码块所使用的语言,实现代码高亮。
比如高亮 python3
代码块:
```python3
#!/usr/bin/env python3
print("Hello, World!");
```
效果如下:
#!/usr/bin/env python3
print("Hello, World!");
- 缩进式插入多行代码
注意: 缩进式插入前方必须有空行; 每行缩进 4 个空格或是 1 个制表符; 一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。
代码:
(此处是个空行,下面的代码每行前面都有 4 个空格或是 1 个制表符)
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
效果如下:
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
# 列表
使用*、+、或-标记无序列表,如:
* 第一项
+ 第二项
- 第三项
效果如下:
- 第一项
- 第二项
- 第三项
注意:标记后面最少有一个 空格 或 制表符。若不在引用区块中,必须和前方段落之间存在空行。
# 分割线
分割线最常使用就是三个或以上 * 或 _ 。
***
****
___
____
效果如下:
# 链接
链接可以由两种形式生成:行内式和参考式。
- 行内式:
[超链接名](超链接地址 "超链接title")。
效果如下:
超链接名。
- 参考式:
[超链接名1][1]
[超链接名2][2]
[1]:超链接地址1 "超链接title1"
[2]:超链接地址2 "超链接title2"
效果如下:
# 图片
添加图片的形式和链接相似,只需在链接的基础上前方加一个!。
- 行内式:
![图片alt](图片地址 "图片title")
效果如下:
- 参考式:
![图片名1][1]
![图片名2][2]
[1]:图片地址1 "图片title1"
[2]:图片地址2 "图片title2"
效果如下:
# 转义字符
通过 反斜杠(\) 将字符转义为普通字母。
\\
\*
\_
注意 前两行代码末尾的\
可以起到换行效果
效果如下:
\
*
_
# 表格
使用“|”和“-”构建表格
| scheme | 对应资源 |
| ------ | ----------------------------- |
| file | 访问本地磁盘上的文件 |
| ftp | 访问远程 FTP 服务器上的文件 |
| http | 访问 WWW 服务器上的文件 |
| news | 访问新闻组上的文件 |
| telnet | 访问 Telnet 连接 |
| gopher | 访问远程 Gopher 服务器上的文件 |
效果如下:
scheme | 对应资源 |
---|---|
file | 访问本地磁盘上的文件 |
ftp | 访问远程 FTP 服务器上的文件 |
http | 访问 WWW 服务器上的文件 |
news | 访问新闻组上的文件 |
telnet | 访问 Telnet 连接 |
gopher | 访问远程 Gopher 服务器上的文件 |