[Markdown]入门篇:开始学习markdown

create: 2018-12-08 | update:2018-12-08

摘要

想要写出有一定排版样式,但是怕富文本太过复杂?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
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;
}