markdown基本语法

Markdown是什么

Markdown是一种轻量级标记语言,它以纯文本形式编写文档,具有易读、易写、易更改的特性,并最终以HTML格式发布,当然你也可以导出为PDF、Word(.docx)、wiki等文件格式。

为什么选择Markdown

  • 它是易读(看起来舒服)、易写(语法简单)、易更改纯文本,学习成本低
  • 比起使用word更简单快速
  • 支持跨平台使用,越来越多的网站也支持了Markdown。
  • 更清晰的组织文档的结构
  • 可以通过HTML和CSS扩展渲染多种样式,实现一键排版
  • 很多markdown编辑器都可以一键导出word、pdf、html等多种文本格式

总的来说就是,markdown能让你无需花大的心思精力在排版和样式上,你专心做的就是写作的内容。

markdown编辑器

平台 编辑器 优点
Web、Android、ios 简书 简单易用可发布文章
Web、Win 小书匠 大量的扩展功能
Web、桌面全平台 Editor.md 开源
Chrome扩展 马克飞象 适合印象笔记重度用户
桌面全平台 Typora 所写即所得,功能强大外观简约
Win/Linux Moe 模仿Moe,颜值赛高
Linux Retext 即时预览
OSX Mou osx下最杰出的编辑器
桌面全平台 Atom、VS code 支持Markdown的两个代码编辑器
Android MarkdownX 手机即可编辑预览

注:笔者用的是Typora

基本语法

标题

两种形式:
1)使用=-标记一级和二级标题。

1
2
3
4
一级标题
===
二级标题
---

效果:

一级标题

二级标题

2)使用#,可表示1-6级标题。

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

列表

使用·+、或-标记无序列表,如:

1
2
3
- 第一项
- 第二项
- 第三项

注意:标记后面最少有一个空格。若不在引用区块中,必须和前方段落之间存在空行。

效果:

  • 第一项
  • 第二项
  • 第三项

有序列表的标记方式是将上述的符号换成数字,并辅以.,如:

1
2
3
1. 第一项
2. 第二项
3. 第三项

效果:

  1. 第一项
  2. 第二项
  3. 第三项

如果你想要建立子列表或者列表描述的话,那就用两个空格再输入内容。

语法:

1
2
3
4
5
+ 父列表1
+ 子列表1
+ 子列表2
+ 父列表2
这里是列表的描述内容

效果:

  • 父列表1
    • 子列表1
    • 子列表2
  • 父列表2
    这里是列表的描述内容

有序列表同理:

语法:

1
2
3
4
5
6
7
8
9
1. 文本1
2. 文本2
- 子文本1
- 子文本2
3. 文本3
1. 子文本3
2. 子文本4
4. 文本4
列表的描述性语言
  1. 文本1
  2. 文本2
    • 子文本1
    • 子文本2
  3. 文本3
    1. 子文本3
    2. 子文本4
  4. 文本4
    列表的描述性语言

区块引用

在段落的每行或者只在第一行使用符号>,还可使用多个嵌套引用,如:

1
2
> 区块引用
>> 嵌套引用

效果:

区块引用

嵌套引用

代码引用

如果是一行或者只是一段文字里面引用部分代码,可以使用符号`括住,如:

1
啊,`java`可以做很多事情。

效果:

啊,java可以做很多事情。

如果是引用一段代码,可以使用符号```括住,如:
```
public interface RouteDefinitionLocator {
Flux getRouteDefinitions();
}
```

效果:

1
2
3
public interface RouteDefinitionLocator {
Flux<RouteDefinition> getRouteDefinitions();
}

你也可以在```后面标识语言来高亮代码,如:
```java
public interface RouteDefinitionLocator {
Flux getRouteDefinitions();
}
```

效果:

1
2
3
public interface RouteDefinitionLocator {
Flux<RouteDefinition> getRouteDefinitions();
}

当然通过4个空格或tab也可以达到同样的效果,只是不能标识语言。

粗体斜体

在强调内容两侧分别加上*或者_,如:

1
2
**粗体**,**粗体**
*斜体*,*斜体*

效果:

粗体粗体

斜体斜体

分割线

三个或更多-_*,必须单独一行,可含空格,如:

1
2
3
---
___
***

效果:




超链接

超链接可以由两种形式生成:行内式参考式自动式

行内式

1
[二当家的黑板报](https://www.edjdhbb.com)

效果:

二当家的黑板报

参考式

1
2
[二当家的黑板报][1]
[1]:https://www.edjdhbb.com "可选标题"

效果:

二当家的黑板报

自动式

1
<https://www.edjdhbb.com>

效果:

https://www.edjdhbb.com

图片引入

图片引入很简单,和超链接格式差不多,只不过在前面增加一个符号!,如:

1
![二当家的头像](https://tva1.sinaimg.cn/large/006tNbRwgy1fy7jd3rqpqj308k08kq30.jpg)

效果:
二当家的头像

反斜杠\

相当于反转义作用,使符号成为普通符号。

表格

冒号表示左对齐、右对齐或居中,如下:

1
2
3
| 博客   |      平台      |  链接 | 推荐程度 |
| -------- | :----------- | ----: | :----: |
| 二当家的黑板报 | 自有 | https://www.edjdhbb.com | 满分 |

效果:

博客 平台 链接 推荐程度
二当家的黑板报 自有 https://www.edjdhbb.com 满分

tips

markdown语法简单好看,很多平台都支持了markdown语法的,如:GitHub、简书、Stack Overflow、CSDN等,一些不支持的平台,如:微信公众号、知乎等,则可以通过一些在线工具(markdown转公众号),一键转换过去。

  • 本文作者:二当家的
  • 本文链接: 2019/01/26/markdown基本语法/
  • 版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-SA 3.0 CN 许可协议。转载请注明出处!
  • 彩蛋: 左边Overview微信公众号二维码,扫描它获取更多技术信息