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语法,
。
三、缩进/空格
由于平时中文的排版习惯,首行通常缩进两字符什么的,所以顺便也了解以下操作,在markdown里这个还稍微有点麻烦,不是敲两下空格键就搞定的。这里需要借用html方面的空格实体。
首先明确1个汉字=2个空格大小
1、一个空格大小的表示
两种用法显示效果一致。
2、两个空格大小的表示
两种用法显示效果一致。
3、不换行空格的表示
也是占一个空格的宽度大小。
四、正文字体
1、粗/斜/删除线/下划线
普通的正文不需要加任何标签,直接打字就OK。但要获得加粗、斜体、删除线等效果,需要在文字左右两侧添加相应的符号。连续两个*
或_
表示加粗, 一个*
或_
表示斜体,~~
表示删除。
那么加粗斜体怎么表示呢?没错,就是连续三个*
或_
。
**加粗**,__加粗__
*斜体*,_斜体_
***加粗斜体***
~~删除~~
显示效果如下:
加粗,加粗
斜体,斜体
加粗斜体
删除
2、反转义符号
/(反斜杠),使其后的符号成为普通符号,不加特效。
\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\#井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号
显示效果如下:
\ 反斜线
` 反引号
* 星号
_ 底线
{ } 花括号
[ ] 方括号
( ) 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
3、字体、字号、颜色
指定字体类型: 我是黑体字
指定字体大小: 我是12号字
指定字体颜色:我是蓝色字 #0099ff 为颜色的16进制代码
指定字体颜色、字号、字体类型黑体
测试一下里面的显示效果:
我是黑体字
显然不行。
测试了其他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. 列表内容
显示效果如下:
- 列表内容
- 列表内容
- 列表内容
(3)列表嵌套
上一级和下一级之间敲三个空格即可。注意符号之后的空格不能少,符号之前的空格也不能少。
+ 一级目录
+ 二级目录
- 三级目录
显示效果如下
- 一级目录
- 二级目录
- 三级目录
- 二级目录
九、插入超链接
链接分两种。一种是链接到其他网上地址的,还有一种是链接到本文中的某个位置的。
两种的基本格式一样。需要添加链接的文字内容用[方括号]来括起来,后面紧跟着带有网址的圆括号,如果要加上连接的title文字,在网址后面,把 title文字放到双引号里面。
[超链接名](超链接地址 "超链接title")
title可加可不加
文字链接 [链接名称](http://链接网址)
网址链接
实例:
[](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}$
显示效果分别为
这一块涉及到的公式符号用法比较多,后续可详细阅读以下这篇文章进行学习:
markdown公式编辑方法介绍
十一、插入绘制表格
使用到的基本符号为|
-
和:
,三个元素之间的多余空格会被忽略,不影响布局。
markdown默认表格标题栏居中对齐,内容居左对齐。
-:
表示内容和标题栏居右对齐,:-
表示内容和标题栏居左对齐,:-:
表示内容和标题栏居中对齐。
内容和|
之间的多余空格会被忽略,每行第一个|
和最后一个|
可以省略,-
的数量至少有一个。
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略
显示效果如下:
表头 | 表头 | 表头 |
---|---|---|
内容 | 内容 | 内容 |
内容 | 内容 | 内容 |
第一格表头 | 第二格表头 |
---|---|
内容单元格 第一列第一格 | 内容单元格第二列第一格 |
内容单元格 第一列第二格 多加文字 | 内容单元格第二列第二格 |
内容单元格 第一列第三格 多加文字 | 内容单元格第二列第三格 |
内容单元格 第一列第四格 多加文字 | 内容单元格第二列第四格 |
注意,使用时发现,表格的语句上一行必须为空行,不然表格不生效。
后续想解锁更多markdown的语法,可前往以下网站进行了解:
- markdown官方文档
- https://markdown.tw/
- w3cschool