markdown常用语法总结

前言

markdown简称md,是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。用md来编写文档、总结都比较便捷。

我使用的md编辑器是MarkdownPad2。
该文档主要参考 Markdown官方教程

下边总结常用的语法。

标题

#表示法

标题的语法就是 : # 后边加空格然后跟标题名,一个#表示一级标题,##表示二级标题,以此类推。

示例:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
...

==表示法

还可以在文本的下方添加任意个===表示一级标题,,任意个--来表示二级标题

示例:

一级标题
=======================

二级标题
------------------------

段落

段落分割

创建段落,使用空白行将上下文进行分割即可。

示例:

段落1
(这里空一行)
段落2

注意: 切记,不可以用空格和制表符(tab)缩进段落!

首行缩进

md语法没有缩进,但是可以使用以下方式变相的实现:

在文本前加上 或  ,表示一个半角空格(分号也不能去掉)。
在文本前加上 或  ,表示一个全角空格(分号也不能去掉)。
在文本前加上 或  ,表示一个不断行的空格(分号也不能去掉)。
示例:
 一个半角空格
  两个半角空格
 一个全角空格
  两个全角空格

效果如下:

这是没有空格

 一个半角空格

  两个半角空格

 一个全角空格

  两个全角空格

换行

以下两种方式几乎所有的md应用程序都适用。其他的方式兼容性较差,此处不列举。
建议看碟下菜。

结尾空格方式

在一行的末尾添加两个或多个空格,然后回车,即可创建一个换行。称为结尾空格的方式。
示例:

这是第一行(注意结尾有两个空格)  
这是第二行

效果:
这是第一行(注意结尾有两个空格)
这是第二行

br标签方式

在一行的结尾添加<br>,即可自动换行
这是第一行<br>这是第二行

效果:
这是第一行
这是第二行

强调

强调一般分为粗体和斜体。

粗体

加粗文本可以在单词或短语前后分别各加**或者__来实现。
加粗单词的中间部分只能加**。
不加粗**加粗**不加粗。
不加粗__加粗__不加粗。

效果:
不加粗加粗不加粗。
不加粗加粗不加粗。

斜体

斜体显示文本可以在单词或短语前后分别各加*或者_来实现。
斜体显示单词的中间部分只能加*。
不斜*斜体*不斜。
不斜_斜体_不斜。

效果:
不斜斜体不斜。
不斜斜体不斜。

同事加粗和斜体

同时加粗斜体显示文本可以在单词或短语前后分别各加***或者___来实现。
加粗斜体显示单词的中间部分只能加***。
不粗斜***加粗斜体***不粗斜。
不粗斜___加粗斜体___不粗斜。

效果:
不粗斜加粗斜体不粗斜。
不粗斜加粗斜体不粗斜。

总结

总结来说就是:在要强调的单词前后分别加不同个数的*或_来实现,具体如下:

*或_:斜体  
**或__:加粗  
***或___:加粗斜体

引用

块引用,渲染效果如下:

块引用效果

块引用,只需在段落前加>符号:

> 块引用效果

块引用效果

嵌套块引用,加两个>>符号:

> 块引用效果
>> 嵌套块引用效果

块引用效果

嵌套块引用效果

说明:
块引用可以包含部分md格式的元素(自己尝试吧)。

列表语法

列表分为有序列表和无序列表。

有序列表

创建有序列表,在开头加数字紧跟一个英文句号(1.)即可。

示例:

1.列表1
2.列表2
...

效果:

  1. 列表1

  2. 列表2

  3. 列表9

  4. 列表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>

效果:
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|


下一篇: