Markdown基本语法总结

  markdown是一种轻量级标记语言,具有纯文本格式语法。它由John Gruber 与Aaron Swartz在2004年合作创建。其目标是让人们“使用易于阅读且易于编写的纯文本格式进行编写,可选将其转换为结构上有效的XHTML或HTML”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

一、标题

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)。
类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶。

1、用#标记

在标题开头加上1~6个#,依次代表一至六级标题。

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

显示效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

注意:#与标题之间最好空有一格,查资料时有博主表示在Visual Studio Code中,#与标题需要空一格,才能渲染为标题,但在简书的markdown编辑器中,#与标题不需要空一格,就能表示标题。

2、用=和-标记

在 标题底下 加上任意个=代表一级标题,-代表二级标题。
这个用法貌似不常用,也比较难用,在我手上好像还不管用,以下纪录一次失败的尝试,不懂怎么回事。

#空一行
主标题
===
副标题
---
一级标题
=========
二级标题
----------

显示效果如下:
主标题
===
副标题


一级标题

二级标题

opps!好像并没有什么卵用...这个主和副标题怎么没变化呢,-这里明摆着显示成了分割线?
注意:一级标题/主标题前方必须留有空行!否则二级标题就默认成为了分隔线,正常效果如下:

主标题

副标题

一级标题

二级标题


既然说到分割线,这里插播一条分割线。

3、分割线

在markdown语法中,一行连用三个或者三个以上的星号,减号,或者下划线,就可以表示分割线。可以在一行用3个以上的 * - _来建立一条分割线,行内除了空格不能有其他东西。
例如:

*** 这里是分割线  
--- 这里也是分割线  
__ 这里还是分割线  

显示效果如下:




据说三条线效果是不同的,按顺序是很明显,不明显,一般。简书的预览效果里我看着三分割线好像也没多大差别。

二、换行

方法1:连敲2个以上空格+enter键;
方法2:利用html语法,<br>

三、缩进/空格

由于平时中文的排版习惯,首行通常缩进两字符什么的,所以顺便也了解以下操作,在markdown里这个还稍微有点麻烦,不是敲两下空格键就搞定的。这里需要借用html方面的空格实体。
首先明确1个汉字=2个空格大小
1、一个空格大小的表示&ensp; &#8194;两种用法显示效果一致。
2、两个空格大小的表示&emsp; &#8195;两种用法显示效果一致。
3、不换行空格的表示&nbsp; &#160;也是占一个空格的宽度大小。

四、正文字体

1、粗/斜/删除线/下划线

普通的正文不需要加任何标签,直接打字就OK。但要获得加粗、斜体、删除线等效果,需要在文字左右两侧添加相应的符号。连续两个*_表示加粗, 一个*_表示斜体,~~表示删除。
那么加粗斜体怎么表示呢?没错,就是连续三个*_

**加粗**,__加粗__  
 *斜体*,_斜体_
***加粗斜体***
~~删除~~

显示效果如下:
加粗加粗
斜体斜体
加粗斜体
删除

2、反转义符号

/(反斜杠),使其后的符号成为普通符号,不加特效。

\\ 反斜杠

\` 反引号

\* 星号

\_ 下划线

\{\} 大括号

\[\] 中括号

\(\) 小括号

\#井号

\+ 加号

\- 减号

\. 英文句号

\! 感叹号

显示效果如下:
\ 反斜线
` 反引号
* 星号
_ 底线
{ } 花括号
[ ] 方括号
( ) 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号

3、字体、字号、颜色

指定字体类型: <font face="黑体">我是黑体字</font>
指定字体大小: <font size=12>我是12号字</font>
指定字体颜色:<font color=#0099ff>我是蓝色字</font> #0099ff 为颜色的16进制代码
指定字体颜色、字号、字体类型<font color=#0099ff size=12 face="黑体">黑体</font>

测试一下简书里面的显示效果:
<font face="黑体">我是黑体字</font>
显然不行。
测试了其他md编辑器,有效显示,但这里简书似乎是不支持的。
这里就附上其他编辑器的效果图吧:


字体样式

由于本地图片路径显示容易出问题,这里用了图床方便生成图片url链接,使用谷歌、新浪微博或者github仓库图床应该都OK。

五、引用

如果一段的内容是引用别人的话,在被引用的文本前加上符号>

> 一个人的命运啊,当然要靠自我奋斗,但是也要考虑到历史的进程。

显示效果如下:

一个人的命运啊,当然要靠自我奋斗,但是也要考虑到历史的进程。

Markdown 标记区块引用的方法是在行的最前面加 > ,也可以只在整个段落的第一行最前面加上 >,区块引用内部可以嵌套,只要根据层次加上不同数量的 >即可,引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等。

>还记得一句教诲吗
> >一个人的命运啊,当然要靠自我奋斗,但是也要考虑到历史的进程。
>>>谁说不是呢

显示效果如下:

还记得一句教诲吗

一个人的命运啊,当然要靠自我奋斗,但是也要考虑到历史的进程。

谁说不是呢

再来试一波儿~~~😄

俄罗斯套娃1

套娃2

套娃3

套娃4

套娃5

套娃6

泥垢了!!!

六、插入代码

对于程序员来说这个功能是必不可少的,插入程序代码的方式有两种,一种是利用缩进(Tab), 另一种是利用“`”符号(一般在ESC键下方)包裹代码。
语法说明:

插入行内代码,即插入一个单词或者一句代码的情况,使用`code`这样的形式插入。代码之间分别用一个反引号包起来
插入多行代码,可以使用缩进或者 ``` code ``` 具体看示例。代码之间分别用三个反引号包起来,且两边的反引号单独占一行

效果如下:
(1)单行代码:
create database coding-girl;
(2)代码块:

function fun(){
  echo "听说你这个小白要学编程";
}
fun();

注意: 缩进式插入前方必须有空行!

七、插入图片

添加图片形式和链接相似,只需要在链接的基础上前方加一个 感叹号。

![图片alt](图片地址  "optional title")
图片alt就是显示在图片下面的文字,相当于对图片内容的解释,可以不写。
图片地址链接可以是图片的本地地址或网址。
图片optional title是图片的标题,当鼠标悬置于图片上时显示的内容。title可加可不加。

显示效果如下:


小猪佩奇

插入本地图片只需要在基础语法的括号中填入图片的位置路径即可,支持绝对路径和相对路径。但本地图片的路径更改或丢失都会造成markdown文件调不出图,不便于分享。
插入网络图片只需要在基础语法的括号中填入图片的网络链接即可,现在已经有很多免费/收费图床和方便传图的小工具可选。

八、插入列表

(1) 无序列表
- + *这三个符号均可以。注意符号与列表内容间要留一个空格。

- 列表内容
+ 列表内容
* 列表内容

显示效果如下:

  • 列表内容
  • 列表内容
  • 列表内容
    (2)有序列表
    语法:数字加点,序号与内容间需要留空格
1. 列表内容
2. 列表内容
3. 列表内容

显示效果如下:

  1. 列表内容
  2. 列表内容
  3. 列表内容
    (3)列表嵌套
    上一级和下一级之间敲三个空格即可。注意符号之后的空格不能少,符号之前的空格也不能少。
+ 一级目录
   + 二级目录
      - 三级目录

显示效果如下

  • 一级目录
    • 二级目录
      • 三级目录

九、插入超链接

链接分两种。一种是链接到其他网上地址的,还有一种是链接到本文中的某个位置的。
两种的基本格式一样。需要添加链接的文字内容用[方括号]来括起来,后面紧跟着带有网址的圆括号,如果要加上连接的title文字,在网址后面,把 title文字放到双引号里面。

[超链接名](超链接地址 "超链接title")
title可加可不加
文字链接 [链接名称](http://链接网址)
网址链接 <http://链接网址>
实例:
[简书](http://jianshu.com) &emsp;<http://jianshu.com>
[我的简书主页](https://www.jianshu.com/u/aaf8afe551a4 "浅羡")

显示效果如下:
简书http://jianshu.com
我的简书主页

十、插入公式

公式左右各加1个$表示行中公式,左对齐,左右各2个$为另起一行居中效果。
我在这里先试一下简单公式

$1+1=2$
$$1+1=2$$
$x_1^2+x_2^3=9$
$\sqrt[4]{\frac xy}$
$\begin{pmatrix}1 & 2 \\ 3 & 4\\ \end{pmatrix}$

显示效果分别为1+1=2
1+1=2
x_1^2+x_2^3=9
\sqrt[4]{\frac xy}
\begin{pmatrix}1 & 2 \\ 3 & 4\\ \end{pmatrix}
这一块涉及到的公式符号用法比较多,后续可详细阅读以下这篇简书文章进行学习:
markdown公式编辑方法介绍

十一、插入绘制表格

使用到的基本符号为| -:,三个元素之间的多余空格会被忽略,不影响布局。
markdown默认表格标题栏居中对齐,内容居左对齐。
-:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐。
内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少有一个。

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略

显示效果如下:

表头 表头 表头
内容 内容 内容
内容 内容 内容
第一格表头 第二格表头
内容单元格 第一列第一格 内容单元格第二列第一格
内容单元格 第一列第二格 多加文字 内容单元格第二列第二格
内容单元格 第一列第三格 多加文字 内容单元格第二列第三格
内容单元格 第一列第四格 多加文字 内容单元格第二列第四格

注意,使用时发现,表格的语句上一行必须为空行,不然表格不生效。


后续想解锁更多markdown的语法,可前往以下网站进行了解:

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

推荐阅读更多精彩内容