MarkDown常用语法介绍

MarkDown常用语法介绍

学习过的内容总要不断的强化,之前只是看过一些markdown的写法,并未真正写过md文档。最近,需要写一些GitHub文档,就深入学习MarkDown的写法,并汇总了这一份文档,且用MarkDown编辑。本文将会介绍一些MarkDown的基本标记语法以及一些常用图形的绘制,包括流程图、甘特图。
MarkDown是一种轻量级标记语言,以一种纯文本的形式编辑,最终可转化为HTML格式发布,能够让编写者沉浸其中,享受文档编写的快乐。


本文目录

一、基本用法


一、基本用法

标题

加在文本前面,将#后的文本作为标题。可实现h1-h6六级标题,按照#的个数区分标题等级。
例如:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

显示效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

区块引用

当你想要单独引用某一段落,就要用到MarkDown中的区块应用>符号,并且可以叠加多个>嵌套使用。
例如:

> 曾经有一份真挚的爱情摆在我面前,我没有珍惜,等到失去了才后悔莫及。(区块引用)
>> 如果再给我一次机会,我想对那个女孩子说三个字。。。 (嵌套引用)

显示效果:

> 曾经有一份真挚的爱情摆在我面前,我没有珍惜,等到失去了才后悔莫及。

>> 如果再给我一次机会,我想对那个女孩子说三个字。。。

注意:   > 和 文本之前记得保留一个空格。

列表

这里的列表是指分条列举,在编辑时,只需要将-加在每行的前面即可,
例如:

- 例子1,我说。。。
- 例子2,我说。。。
- 例子3,我说。。。
- 例子4,我说。。。

- 例子4的介绍。。。。

显示效果:

  • 例子1,我说。。。

  • 例子2,我说。。。

  • 例子3,我说。。。

  • 例子4,我说。。。

    • 例子4的介绍。。。。

    如果想要将前面的原点换成数字,变成有序列表,那就在每行前面加 1.  2.  3.  即可。

例如:
1. 例子1,我说。。。
2. 例子2,我说。。。
3. 例子3,我说。。。
4. 例子4,我说。。。
  4.1 例子4的介绍。。。

显示效果:

  1. 例子1,我说。。。
  2. 例子2,我说。。。
  3. 例子3,我说。。。
  4. 例子4,我说。。。
    4.1 例子4的介绍。。。

粗体和斜体

粗体或者斜体的使用就更简单了,只需要在需要强调的文本左右加上*或者_

例如:

*我是谁*(斜体
_我在哪儿_ (斜体
**我是谁**(粗体
__我在哪儿__ (粗体

显示效果:

我是谁斜体
我在哪儿斜体
我是谁粗体
我在哪儿粗体

代码引用

代码引用的时候,需要在每个代码行前面加一个Tab或者4个空格,也可以使用 , 单行使用 包裹,多行使用```包裹代码,效果与tab相同。
例如:
普通段落

function add (x, y) {
return x + y;
}
代码块:

function add (x, y) {
    return x + y; 
}
function () {

}

链接与图片

链接和图片的添加方法类似,方法有两种行内式和参数式。(也可使用html的方法,通过<a></a>添加)
链接:

[我是Github,请点我](https://github.com/HamsinD/MarkDown_summary) (行内式)
效果我是Github,请点我

[我是Github,请点我](Github) (参数式)
[Github](https://github.com/HamsinD/MarkDown_summary)
效果
我是Github,请点我

添加图片只需要在链接的格式前面加!
图片:

![gugong](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1539059811385&di=9902f126f1b4cf55c41ecedc46140998&imgtype=0&src=http%3A%2F%2Fimgsrc.baidu.com%2Fimgad%2Fpic%2Fitem%2Fcc11728b4710b912fcc749f6c9fdfc03924522b7.jpg)
效果:

表格

表格的写法比较有意思,通过|-来绘制表格,具体看写法:

| tab1       | tab2     | tab3    |
| ---------- |:--------:| -------:|
| xxxxxxx    | xxxxxxx  | xxxxxxx |
| xxxxxxx    | xxxxxxx  | xxxxxxx |

显示效果:

tab1 tab2 tab3
xxxxxxx xxxxxxx xxxxxxx
xxxxxxx xxxxxxx xxxxxxx

注意: 表头线-两侧的:用来设置居中方式。

注意点:

  1. 段落的前后要有空行,所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。
  2. 一个空格输入&nbsp;即可
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,794评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,050评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,587评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,861评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,901评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,898评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,832评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,617评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,077评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,349评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,483评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,199评论 5 341
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,824评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,442评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,632评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,474评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,393评论 2 352

推荐阅读更多精彩内容

  • Markdown是一种电子邮件风格的标记语言,应用非常广泛。 0. 心得 为了写这篇文章我发了一个下午时间,为什么...
    明天会更好iOSer阅读 720评论 0 2
  • 什么是Markdown语法? Markdown 是一种轻量级标记语言,目标是实现「易读易写」 标题 在传统文本编辑...
    冷的像风阅读 348评论 0 1
  • Markdown 百度百科Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使...
    Superman168阅读 285评论 0 1
  • Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式...
    hydralwz阅读 214评论 0 0
  • 标题 一级标题 二级标题 三级标题 四级标题 五级标题 字体加粗 加粗 引用 无序列表 无序列表 无序列表 无序列...
    张柴柴阅读 1,139评论 0 96