Markdown 语法文档

Markdown 语法文档

前言

Markdown 是一种轻量级标记语言,创始人为約翰・格魯伯(英语:John Gruber);

它允许人们 “使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者 HTML)文档”;

这种语言吸收了很多在 电子邮件中已有的纯文本标记的特性;

—— 维基百科

Markdown 的部分标记有几种不同的符号,但是实现的效果都是相同的,所以文章中每种实现的效果我只写一种符号,一般都是方便且较常用的标记符号;


标题

# H1
## H2
### H3
#### H4

# 的数量代表标题的级别;


段落与格式

段落

我是第一段

我是第二段

段落之间加入空行实现换行效果,如无空行,换行符会转换成空格;

我是第一段  
我是第二段

在前一段落末尾加上至少两个空格,也可实现换行;

字体格式

*斜体字体*
**加粗字体**
***加粗斜体***

段落两端加上对应数量 *(星号),即可实现以上三种效果;

删除线

~~删除线~~

段落两端加上 ~~ 即可实现 删除线 效果;

下划线

<u>下划线</u>

Markdown 语言中没有 下划线 标记,但是 Markdown 支持 HTML 标记,所以可以通过 HTML 的 <u> 标记实现 下划线 效果;


引用内容

单行引用

>时间就是生命,我的朋友

时间就是生命,我的朋友

多行引用

>多行引用如果需要换行
>可在两行之间添加空行
>
>或在换行前的行末添加两个空格

多行引用如果需要换行
可在两行之间添加空行

或在换行前的行末添加两个空格

嵌套引用

>时间就是生命,我的朋友
>>Yes!

时间就是生命,我的朋友

Yes!


列表

有序列表

1. 列表一
2. 列表二
	1. 子列表一
	2. 子列表二
3. 列表三
  1. 列表一
  2. 列表二
    1. 子列表一
    2. 子列表二
  3. 列表三

无序列表

- 第一种实现符号
+ 第二种实现符号
	+ 嵌套列表
	+ 嵌套列表
* 第三种实现符号
  • 第一种实现符号
  • 第二种实现符号
    • 嵌套列表
    • 嵌套列表
  • 第三种实现符号

TODO 列表

- [ ] TODO 1
- [ ] TODO 2
	- [ ] TODO 2.1
	- [x] TODO 2.2
- [x] TODO 3

TODO

博客园暂不支持 TODO 列表;


代码

行内代码

全选:`Ctrl` + `A` 

全选:Ctrl + A

代码块

​```
我是代码块
​```
我是代码块

注:1、3 行的 ``` 就是代码块的实现符号;

代码高亮

​```C#
using System;

class Markdown{ }
​```
using System;

class Markdown{ }

注:在行首 ``` 后加上代码语言的名字,即可实现对应的代码高亮;


邮箱

<address@email.com> 

address@email.com


链接

内联链接

[Light's Note](https://www.cnblogs.com/Light-/ "Light's Note(可选)")

Light's Note

<https://www.cnblogs.com/Light-/>

https://www.cnblogs.com/Light-/

外联链接

[Light's Note][blog_Url]

[blog_Url]:https://www.cnblogs.com/Light-/ "Light's Note(可选)"

Light's Note


图片

内联图片

![我的头像](https://pic.cnblogs.com/avatar/1645312/20190418233348.png "Ligth's Note(可选)")

我的头像

外联图片

![我的头像][png_url]

[png_url]:https://pic.cnblogs.com/avatar/1645312/20190418233348.png "Light's Note(可选)"

我的头像


表格

使用 | 分隔单元格,- 分隔表头和其他行;

表头 | 表头
----- | -----
单元格 | 单元格
单元格 | 单元格
表头 表头
单元格 单元格
单元格 单元格

单元格对齐

:- :左对齐

:-: :居中

-: :右对齐

表头 | 表头 | 表头
:---- | :-: | ----:
左对齐 | 居中 | 右对齐
左对齐 | 居中 | 右对齐
表头 表头 表头
左对齐 居中 右对齐
左对齐 居中 右对齐

高级技巧

HTML 标记

Markdown 是一种标记语言,且同时兼容另一种标记语言 HTML (博客园暂只支持部分简单标记),所以我们也可以直接在文档中使用相关标记,例如:

<u> 下划线

<u>下划线文本</u> 

下划线文本

<kbd> 键盘框

全选:<kbd>Ctrl</kbd> + <kbd>A</kbd> 

全选:Ctrl + A(博客园暂不支持)

<i> 内嵌图标

<i class="icon-weibo"></i>

更多的图标和玩法可以参看 font-awesome 官方网站;(博客园暂不支持)

转义字符

Markdown 的占用了很多常用符号,如:*-~

如果我们写文档时需要显示这些符号,可以使用转义字符:\标记符号 转义为 普通符号 显示出来;

*斜体文本*
\*斜体文本\*

斜体文本
*斜体文本*

**加粗文本**
\*\*加粗文本\*\* 

加粗文本
**加粗文本**

分隔符

---



使用至少三个 - (减号),加上一个空行,实现分隔符;

脚注

Light's Note 里面的文章真棒![^脚注标题]

[^脚注标题]: 是的,我也这么觉得~

Light's Note 里面的文章真棒![1]


  1. 是的,我也这么觉得~ ↩︎

posted @ 2019-04-25 14:09  Lianginx  阅读(1276)  评论(0编辑  收藏  举报