摘要
想要写出有一定排版样式,但是怕富文本太过复杂?markdown简洁的语法帮你快速撰写一篇文章。
相关文章
入门篇:开始学习markdown
基础篇:语法高亮预览
markdown基础语法
标题
想要文章的层次清晰,你可以使用1~6个#
来设置该行是几级标题。语法是n个#
加空格
然后加上内容。注意该行内容任然能够被其他语法修饰。否则,当你忘记加空格的时候,将无法转义。
1~6级标题对应的语法如下
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果如下
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
当然,你也可以在一行文字下方添加3个及以上的=
或-
,则分别可以把这行文字变为一级标题和二级标题。
文字1
===
文字2
---
显示效果
文字1
文字2 —
文本修饰
一般的markdown编辑器都支持加粗,斜体,斜体加粗,和删除线,也有部分markdown编辑器支持强调语法。
**加粗** *斜体* ***斜体加粗*** ~~删除线~~ ==强调==
效果如下
加粗 斜体 斜体加粗 删除线 ==强调==
文本内容
markdown语法有时会有些奇怪,在编辑器中你换行了,但是显示的时候却没有换行,这里有两种方法来换行你需要的文字。较好的实践是经常在不同元素之间插入空行。
例如这一段文字,一般来说显示出来并不会换行。
文本行1
文本行2
显示效果
文本行1 文本行2
1.你可以插入一个空行来换行。
文本行1
文本行2
显示效果
文本行1
文本行2
2.你也可以插入一个换行标签<br/>
来换行
文本行1<br/>
文本行2
显示效果
文本行1
文本行2
3.在第一行文字结尾连续敲3次及以上空格键
显示效果
文本行1
文本行2
附加内容
1.引用块
注意,>
和内容之间需要有一个空格。
> 你需要引用的内容
显示效果如下
你需要引用的内容
当然你也可以嵌套引用
> 你需要引用的内容
>> 你需要引用的内容
>>>>> 你需要引用的内容
显示效果如下
你需要引用的内容
你需要引用的内容
你需要引用的内容
2.分割线
分割线将会单独占用一行,你可以使用3个及以上的-
或*
来表示分割线。
-----
*****
效果如下
3.链接
当你需要插入链接时,用[comment](address)
来显示链接,其中comment为显示的文字,address为链接的地址。
[转到我的另一篇文章](https://h1542462994.github.io/blog/2018/12/08/build-blog-2/)
效果如下
4.图片
当你需要插入图片时,可以用![]()
来显示,[]
内的东西填任何东西,有些地方可以在图片下方显示这些文字。()
主要用于写链接和title,其中title可省略,格式为(address "title")
![示例图](http://h1542462994.github.io/media/screenshot/newtagstyle1.jpg "标题")
效果如下
5.列表
你想要以列表的方式罗列信息,你可以用列表语法,但是很奇怪,有些编辑器在显示列表时会出现显示异常的问题。在行首,你可以使用一个-
、+
或*
加一个空格并添加文字就能显示列表。
+ 列表1
- 列表2
* 列表3
显示效果
- 列表1
- 列表2
- 列表3
嵌套列表:你可以在行首额外打上n*4个空格或者一个n个tab,从而向内缩进。
+ 列表1
+ 列表2
+ 列表3
+ 列表4
- 列表5
显示效果
- 列表1
- 列表2
- 列表3
- 列表4
- 列表5
- 列表2
6.表格
当你需要显示表格时,你可以用表格语法,不过记住,在使用表格是上一行应该是空行,而且表格需要有表头,否则可能无法显示表格。
| column1 | column2 | column3 |
| --- | :---: | ---: |
| content | content | content |
| content | content | content |
显示效果如下
column1 | column2 | column3 |
---|---|---|
content | content | content |
content | content | content |
第二行用来区分表头和表体,每行的单元格的个数需要统一,第二行用n个-
来表示,两边的:
(半角)是用来说明对其方式的,---
或:---
是左对齐,:---:
是居中对齐,---:
是右对齐。
7.代码块
想要以块状的方式显示整段代码还是高亮某几个文字,你可以使用代码快语法。当然,在代码块内的所有内容是无法由markdown编辑器转移的。其用到的特殊字符`在esc键的下方,但是你需要切换标点符号为半角模式。
单行代码
`要高亮的文本`
显示效果
要高亮的文本
多行代码
用分行的三个反括号将代码块括起来,如果在第一行后面添加特定的名称,它能够按照相应的语法高亮关键文本。
(```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;
}