# Markdown 介绍
Markdown 是一种轻量级标记语言,由约翰・格鲁伯(左)于 2004 创建(在语法上与亚伦・斯沃茨(右)有合作). 它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 HTML
文档。其中最重要的设计是可读性,也就是说这个语言应该要能直接在字面上阅读,而不用记忆格式化指令标记(像是 RTF
与 HTML). 由于 Markdown 的轻量化、易读易写特性,并且对于图片、图表、数学式都有支持,目前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。如 GitHub
、 Reddit
、 Discord
、 OpenStreetMap
、 CSDN
、 简书
等,甚至还能被用来撰写电子书.
# 基本语法
# 标题
Markdown 支持六级标题,要使用几级标题即在标题前方加上相应数目的 #
(兼容性:标题与 #
之间添加空格), 例如三级标题 ###
.
# Heading lebel 1 | |
## Heading lebel 2 | |
### Heading lebel 3 | |
#### Heading lebel 4 | |
##### Heading lebel 5 | |
###### Heading lebel 6 |
Ctrl 1~6
可将对应的文本设置成相应级别的标题,Ctrl + 0
将文本设成正文Ctrl +
或Ctrl -
将相应的标题进行升级或者降级
# 段落与换行
使用空白行或多行文本进行分割。需要注意的是 ' 回车 ' 和 Shift 回车
不同,前者的行间距更小。同时 Markdown 并不建议使用空格(spaces)或制表符( tabs)来缩进段落.
# 强调语法
粗体:在需要加粗的单词或者短语的前后各添加
**
或者__
(两个下划线). Here. 快捷键 —— 选中文本,Ctrl b
斜体:在需要用斜体的文本的前后各添加
*
或者_
(一个下划线). Here. 快捷键 —— 选中文本,Ctrl L
下划线:将需要使用下划线的文本放置于
<u></u>
标签对内. <u>Here</u>. 快捷键 —— 选中文本,Ctrl u
高亮:对需要使用的高亮文本前后分别添加
==
. Here.删除线:对需要使用的删除线的文本前后分别添加
~~
.Here. 快捷键 —— 选中文本,SHift Alt 5
# 列表
- 有序列表:要创建有序列表,在每个列表项前添加数字并紧跟一个英文句点 (
.
). 数字不必按数学顺序排列,但是列表应当以数字 1 起始. - 无须列表:要创建无序列表,在每个列表项前添加
-
、*
或+
并紧跟一个空格。可以通过缩进的方式来创建嵌套列表 (Tab
). - 任务列表:要创建无序列表,在每个列表项前添加
- [ ]
(-
空格[
空格]
空格).
有序列表: | |
1. item 1 | |
2. item 2 | |
3. item 3 | |
无序列表 | |
- item 1 | |
- item 2 | |
- item 3 | |
任务列表 | |
- [ ] task1 | |
- [x] task2 |
# 引用
要创建块引用,请在段落前添加一个 >
符号。引用可以包含多个段落,需要为每个段落之间空白行添加一个 >
符号。引用可以和其他语法嵌套使用,当绕也可以可以引用嵌套使用.
> 第一是生活,第二是生活,第三还是生活,没有生活,爱便没有附丽。 —— 鲁迅 |
第一是生活,第二是生活,第三还是生活,没有生活,爱便没有附丽。 —— 鲁迅
# 代码块
要将单词或短语表示为代码,请将其包裹在反引号 ( \``) 中. 代码块放置于三个
` 内. **快捷键** —— 选中代码块
Ctrl Shift k`
```cpp | |
#include <iostream> | |
using namespace std; | |
int main(){ | |
cout << "Hello World" << endl; | |
return 0; | |
} | |
``` |
#include <iostream> | |
using namespace std; | |
int main(){ | |
cout << "Hello World" << endl; | |
return 0; | |
} |
# 链接
链接语法: [Value's Blog](https://special-jiahao.github.io/)
, 链接文本放在中括号内,链接地址放在后面的括号中。链接 title 是当鼠标悬停在链接上时会出现的文字,这个 title 是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。链接地址也可以为邮箱地址. 快捷键 —— 选中代码块 Ctrl K
[Value's Blog](https://special-jiahao.github.io/ "Value's blog") |
渲染效果:Value's Blog
同样链接功能不仅仅可以实现站外链接,还可以实现站内链接。实现方式如下:
跳转至基本语法:[Click me](#基本语法) | |
↑手动删除#与文字之间的空格 |
跳转至基本语法:Click me
# 分割线
要创建分隔线,需要再单独一行上使用三个或多个星号 ( ***
)、破折号 ( ---
) 或下划线 ( ___
) , 并且不能包含其他内容。渲染效果如下所示:
# 图片
图片语法: ![this is a picture]("picture url" "title")(skip url)
. 要添加图像,请使用感叹号 ( !
), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。如果需要为图片添加跳转链接,在 skip url
内填入指定的链接地址. 快捷键 —— Ctrl Shift I
.
[![](https://s1.ax1x.com/2023/07/24/pCOelT0.md.jpg "万家灯火")](https://special-jiahao.github.io/) |