前言
markdown简称md,是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。用md来编写文档、总结都比较便捷。
我使用的md编辑器是MarkdownPad2。
该文档主要参考 Markdown官方教程
下边总结常用的语法。
标题
#表示法
标题的语法就是 : # 后边加空格然后跟标题名,一个#表示一级标题,##表示二级标题,以此类推。
示例:
# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ...
==表示法
还可以在文本的下方添加任意个===表示一级标题,,任意个--来表示二级标题
示例:
一级标题 ======================= 二级标题 ------------------------
段落
段落分割
创建段落,使用空白行将上下文进行分割即可。
示例:
段落1 (这里空一行) 段落2
注意: 切记,不可以用空格和制表符(tab)缩进段落!
首行缩进
md语法没有缩进,但是可以使用以下方式变相的实现:
在文本前加上 或  ,表示一个半角空格(分号也不能去掉)。 在文本前加上 或  ,表示一个全角空格(分号也不能去掉)。 在文本前加上 或  ,表示一个不断行的空格(分号也不能去掉)。 示例:  一个半角空格   两个半角空格  一个全角空格   两个全角空格
效果如下:
这是没有空格
一个半角空格
两个半角空格
一个全角空格
两个全角空格
换行
以下两种方式几乎所有的md应用程序都适用。其他的方式兼容性较差,此处不列举。
建议看碟下菜。
结尾空格方式
在一行的末尾添加两个或多个空格,然后回车,即可创建一个换行。称为结尾空格的方式。
示例:
这是第一行(注意结尾有两个空格) 这是第二行
效果:
这是第一行(注意结尾有两个空格)
这是第二行
br标签方式
在一行的结尾添加<br>,即可自动换行 这是第一行<br>这是第二行
效果:
这是第一行
这是第二行
强调
强调一般分为粗体和斜体。
粗体
加粗文本可以在单词或短语前后分别各加**或者__来实现。 加粗单词的中间部分只能加**。 不加粗**加粗**不加粗。 不加粗__加粗__不加粗。
效果:
不加粗加粗不加粗。
不加粗加粗不加粗。
斜体
斜体显示文本可以在单词或短语前后分别各加*或者_来实现。 斜体显示单词的中间部分只能加*。 不斜*斜体*不斜。 不斜_斜体_不斜。
效果:
不斜斜体不斜。
不斜斜体不斜。
同事加粗和斜体
同时加粗斜体显示文本可以在单词或短语前后分别各加***或者___来实现。 加粗斜体显示单词的中间部分只能加***。 不粗斜***加粗斜体***不粗斜。 不粗斜___加粗斜体___不粗斜。
效果:
不粗斜加粗斜体不粗斜。
不粗斜加粗斜体不粗斜。
总结
总结来说就是:在要强调的单词前后分别加不同个数的*或_来实现,具体如下:
*或_:斜体 **或__:加粗 ***或___:加粗斜体
引用
块引用,渲染效果如下:
块引用效果
块引用,只需在段落前加>符号:
> 块引用效果
块引用效果
嵌套块引用,加两个>>符号:
> 块引用效果 >> 嵌套块引用效果
块引用效果
嵌套块引用效果
说明:
块引用可以包含部分md格式的元素(自己尝试吧)。
列表语法
列表分为有序列表和无序列表。
有序列表
创建有序列表,在开头加数字紧跟一个英文句号(1.)即可。
示例:
1.列表1 2.列表2 ...
效果:
列表1
列表2
列表9
列表6
说明:序号可以不按顺序来,但是第一个一定必须是1。
无序列表
创建无序列表,只需在前边加破折号-或星号*或者加号+。
还可以嵌套列表。
- 列表1 * 列表2 + 列表3 - ...
列表1
列表2
列表3
列表3.1
列表3.2
列表3.3
代码块
部分单词或短语代码
要将单词或短语表示为代码,将其包裹在反引号`中.
这里不是代码`这里是代码`这里不是代码
效果:
这里不是代码 这里是代码
这里不是代码
段落代码块
空格方式
要将一整段文字作为代码块,可以直接缩进四个空格或一个制表符。 (其实整篇文章已经多处用到代码块~)
前边空四个空格,那么这一行都是代码
效果:
前边空四个空格,那么这一行都是代码
围栏代码块
如果很多行代码,使用空格或tab制表符比较不方便,md允许使用围栏代码块:在代码的首尾各添加三个反引号```或三个波浪线~~~:
\~~~ 代码块 代码块 代码块 代码块 \~~~
效果: ~~~ 代码块 代码块 代码块 代码块 ~~~~
`反引号转义
针对7.1描述的,一个`表示代码块,如果我们需要用到此符号引住一个单词或短语,就需要转义。
使用\`即可转义:
\`这是反引号引住的内容\`
效果:
`这是反引号引住的内容`
分隔线
要创建分隔线,在单独一行使用至少三个星号(***)或破折号(---)或下划线(___),且不能包含其他内容:
*** --- ___
效果:
链接
常规方式
链接的语法:链接的文本在中括号中,地址在后边的括号中,链接title可选:
[百度一下吧](http://www.baidu.com "测试百度链接")
效果:
这是个百度链接 百度一下吧
(这里的title是指--你把鼠标放上去不要动看看提示是啥~)
直接显示网址
还可以直接显示链接:在<>中输入网址或邮箱地址即可。
<http://www.baidu.com>
图片
显示图片
如果要显示图片,先来个!,然后在后边加中括号,中括号里是显示的文本内容,紧接着来个小括号,小括号内是图片和title:
![这是图片哟](https://markdown.com.cn/assets/img/philly-magic-garden.9c0b4415.jpg "图片title")
链接图片
如果显示图片,且可以跳转,则可以结合显示图片和链接一起:
[![这是图片哟](https://markdown.com.cn/assets/img/philly-magic-garden.9c0b4415.jpg "图片title")](https://markdown.com.cn/assets/img/philly-magic-garden.9c0b4415.jpg)
转义字符
在前文已经提到转义字符。md中的转义字符就是\。
如果需要转义,直接在字符前加上\即可。
md可转义的字符如下:
| 字符 | 含义 | | -------- | -------- | | \ | 转义字符| | ` | 反引号 用来括住部分代码块| | * | 星号| | _ | 下划线| | # | 井号| | + | 加号| | - | 减号| | . | 点| | ! | 感叹号| | \| | 管道| | {} | 一对大括号| | [] | 一对中括号| | () | 一对小括号|
表格
添加表格,请使用三个或多个---创建每列的标题,使用管道|分割每列。
示例:
|标题1|标题2| |-----|-----| |第一行1|第一行2| |第二行1|第二行2|
显示效果:
|标题1|标题2| |-----|-----| |第一行1|第一行2| |第二行1|第二行2|
对齐: 可以通过在标题行中的连字符左侧、右侧、两侧添加冒号,分别表示列中的文本左对齐、右对齐、居中对齐。
|标题1左对齐|标题2右对齐|标题3居中对齐| |:-----|-----:|:-----:| |第一行1|第一行2|第一行3| |第二行1|第二行2|第二行3|
效果:
|标题1左对齐|标题2右对齐|标题3居中对齐| |:-----|-----:|:-----:| |第一行1|第一行2|第一行3| |第二行1|第二行2|第二行3|