Markdown的编辑语法-一篇全

写在前面,本篇参考了简书的教程,自己做了整理和补充和精简,并且修正了一些错误。全片的语法自己都在Markdownpad和Typora实际尝试过,markdown语法适用于Markdownpad,Typora等markdown编辑器,其中Markdownpad不支持流程图和时序图,需要安装插件。

1. 标题

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

#号后需要加一个空格,一共有6级,一个#对应一级,下面是效果:

2. 引用

> 种花家的明天靠你们了

效果如下:

种花家的明天靠你们了

注:
1.如果想嵌套引用,则在引用体中用不同数量的>来实现嵌套引用;
2.如果你在引用体后面直接换行输入,那么该行还会被纳入引用体,因此你需要输入两次换行达到脱离引用;

3. 列表

列表有三种情况,有序列表、无序列表和层级列表,有序列表只需前面加上- 或者*后面接个空格:

3.1 无序列表

- 首页 或 * 首页
- 文件 或 * 文件
- 编辑 或 * 编辑
- 帮助 或 * 帮助

效果如下:

  • 首页
  • 文件
  • 编辑
  • 帮助

3.2 有序列表

有序列表则直接在文字前加一、 二、 三、 或者其他的序列格式1. 2. 3.:

1. 首页
2. 文件
3. 编辑
4. 帮助

效果如下:

  1. 首页
  2. 文件
  3. 编辑
  4. 帮助

3.3 层级列表

层级列表一般只支持三级,第一级实心圆点,第二级空心圆点,第三级以后都是实心方点。要实现层级列表,每下一级在开头加上-后还要在-前比上一级多输入2个Space或者1个Tab,而且第一级前面不要超过3个Space:

- 一级列表
	- 二级列表
		- 三级列表

效果如下:

  • 一级列表
    • 二级列表
      • 三级列表

列表前加上可选择方框

- [ ] 计划任务
- [ ] 完成任务

效果如下:

  • 计划任务
  • 完成任务

4. 斜体、粗体

*我是斜体*
**我是粗体**

效果如下:

我是斜体
我是粗体

5. 超链接

[]()

中括号里为显示内容,小括号里为链接地址

[Git下载安装程序](https://git-scm.com/downloads)

效果如下:

Git下载安装程序

6. 插入图片

6.1 格式

![]()

插入图片格式和超链接格式非常类似,只是在前面需要加个!感叹号:, 连接地址可以为网络地址,也可以为本机地址,推荐在正在写的markdown文档下创建images文件夹然后使用绝对地址。

![](images/git_install_success.jpg)]

效果如下:

窗口显示

6.2 改变图片大小

图片默认就是靠左显示,展示的图片大小也是固定的,而且不能使用div标签,但在很多Markdown编辑器中可以设置图片大小的,语法如下:

<img src="images/git_install_success.jpg" width="300" height="300" alt="窗口显示"/>

也可以将"300"换为比例,如

<img src="images/git_install_success.jpg" width=30% height=30% alt="窗口显示"/>

6.3 居中、靠右、靠左显示:

<div align=center>[(images/git_install_success.jpg)]

将center换为right,left 则为居右,居左

6.4 同时改变大小位置

<div align=center>
<img src="images/git_install_success.jpg" width="300" height="300" div align=center/>
</div>

效果图如下:

7. 换行、分割线

1. </br>
2. <br />

Markdown换行符有两种形式:
“/br”是连写的,而“br /”之间有一个空格

如今,邮政的寄件效率已经大大提升,EMS:3天,普快:一周,平邮:半月。</br>当然不过也有例外,有网友在Twitter晒图声称,最近自己收到了3年前的邮政EMS包裹,两部iPhone 5。

效果图如下:

如今,邮政的寄件效率已经大大提升,EMS:3天,普快:一周,平邮:半月。当然不过也有例外,有网友在Twitter晒图声称,最近自己收到了3年前的邮政EMS包裹,两部iPhone 5。

分割线的语法只需要三个 * 号:

***

效果如下:


8. 代码块

8.1 方法1

一行的代码:

`if (textField.text.length >= 6 && textField.text.leng <= 12);`

多行的代码:

```
if (textField.text.length >= 6 && textField.text.leng <= 12);
if (textField.text.length >= 6 && textField.text.leng <= 12);
if (textField.text.length >= 6 && textField.text.leng <= 12);
```

效果如下:

if (textField.text.length >= 6 && textField.text.leng <= 12);
if (textField.text.length >= 6 && textField.text.leng <= 12);
if (textField.text.length >= 6 && textField.text.leng <= 12);

8.2 方法2

	按1下Tab键

效果如下:

按1下Tab键

9. 转义字符

有时候你在输入了某些字符后,本来希望只是普通文本显示,但是却把排版搞的一团糟,比如:

`符号代表代码块符号,前后各用一个`包裹起来

不加转义字符,显示的效果如下:

符号代表代码块符号,前后各用一个 包裹起来

原本只是介绍 ` 这个字符代表的意思,文本却识别出 ` 是代码块符号,所以在两个 ` 之间包裹了起来,这时转义字符 “ \ ”就有用武之地 了,在这些字符前面加上反斜杠 “ \ ” ,这时候这些字符就被看作是纯文本,并不是特殊字符了,如:

\`符号代表代码块符号,前后各用一个\`包裹起来

显示效果就是:

`符号代表代码块符号,前后各用一个`包裹起来

注意,一个“\”只作用于紧跟其后的一个完整意义字符或者字符串,如果是多个字符或者字符串形成某种格式转换,这时你又想作为普通文本输出,那么就需要在多处加上“ \ ”反斜杠了。

10. 首行缩进和目录

由于markdown语法主要考虑的是英文,所以对于中文的首行缩进并不太友好,以下两种方法都可以完美解决这个问题。

把输入法由半角改为全角。 两次空格之后就能够有两个汉字的缩进。
在开头的时候,先输入下面的代码,然后紧跟着输入文本即可。分号也不要掉。 然后直接写文本。

半方大的空白的代码为 &ensp;或&#8194;
全方大的空白的代码为 &emsp;或&#8195;
不断行的空白的代码为 &nbsp;或&#160;

例如:

&emsp;&emsp;这是一个首行缩进段落

显示效果:

  这是一个首行缩进段落

目录只需要输入[TOC]然后回车,将会产生一个目录,这个目录抽取了文章的所有标题,内容会自动更新;markdownpad2 软件输出html会自动生成目录不需要加[TOC]了。

11. 删除线

~原价¥888~

在markdownpad2中前端预览是js渲染的,后端输出php处理的,与typora两者的markdown语法有差异, ~ 来做删除线被认为是不规范的markdown语法,js渲染那边会去掉。

可以用 del
语法:<del> 我是被删除的 </del>

效果图如下:

原价¥888

12. 表格

| 项目    | 时间        | 负责人   |
| ------- |:---------:| -------:|
| 项目一   | 2017.6     |  小袁   |
| 项目二   | 2017.7     |  小付   |
| 项目三   | 2017.8     |  小明   |

语法如下:

| - :之间的多余空格会被忽略,不影响布局。
默认标题栏居中对齐,内容居左对齐。
-:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐。
内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少有一个。
上诉语法得出表格:

效果图:

项目时间负责人
项目一2017.6小袁
项目二2017.7小付
项目三2017.8小明

13. 流程图

流程图的语法大体分为两部分:

(定义元素)前面部分用来定义流程图元素;
(连接元素)后面部分用来连接流程图元素,指定流程图的执行走向。
然后写在下面代码块里面:

13.1 定义元素

tag=>type: content:>url

tag:标签,连接元素时使用
type:该标签的类型
content:流程语句中放置的内容
url:链接,与流程语句绑定

注:其中type共有6种类型如下:

start,用来声明流程图的开始;
end,用来声明流程图的结束;
operation,长方形
subroutine,子程序
condition,用来声明流程图的判断;
inputoutput,四边形

type:与content之间一定要有一个空格

13.2 连接元素

使用->符号,表示连接
例如:
step1(yes)->step2->step3

举例子如下:

```flow

st=>start: Start
e=>end: End
op=>operation: My Operation
cond=>condition: Yes or No?
st->op->cond
cond(yes)->e
cond(no)->op
```

得到如下图:

Created with Raphaël 2.2.0 Start My Operation Yes or No? End yes no

14. 时序图

语法如下:

```sequence
A->B: 连接

实例如下:

```sequence
participant A
participant B
participant C

A->B: 方法
```

效果图:

A B C 方法 A B C

解释:

participant A 代表对象
- 代表实线 , 主动发送消息
> 代表实心箭头 , 同步消息
-- 代表虚线,表示返回消息
>> 代表非实心箭头

15. 插入公式

使用Latex插入数学公式的时候,需要安装Latex插件.
Typora软件中使能Latex语法的操作步骤
VScode中需要下载Markdown math插件。
具体的公式语法:
插入公式

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值