目录

Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

由于 Markdown 的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书 等。甚至Markdown能被使用来撰写电子书。

因为正在学习 Markdown,所以准备写篇文章来练练手,这篇文章就是用 Markdown 写的。Markdown 其实很简单,比 HTML 简单多了,只需要花几分钟时间阅读一下文档,在写几篇文章练练手,基本上就会使用了。

关于编辑器:我现在使用的是 Visual Studio Code,配合 Markdown Preview Enhanced 插件可以实现实时预览。除了 Visual Studio Code 外其他也有很多好用的编辑器,但因为我还要写其他语言的代码,所以直接用 VsCode 了。

VSCode截图

这里也推荐一个 Markdown 编辑器 Typora,这是一款很强大的 Markdown 编辑器,拥有所见即所得功能,哪怕你不会 Markdown 也能无障碍的使用,软件不仅有颜值,而且还是免费的。

Typora

标题

下面是6种标题的写法:

# 一级标题,类似于HTML的h1
## 二级标题,类似于HTML的h2
### 三级标题,类似于HTML的h3
#### 四级标题,类似于HTML的h4
##### 五级标题,类似于HTML的h5
###### 六级标题,类似于HTML的h6

下面是效果:

一级标题,类似于HTML的h1

二级标题,类似于HTML的h2

三级标题,类似于HTML的h3

四级标题,类似于HTML的h4

五级标题,类似于HTML的h5
六级标题,类似于HTML的h6

注意!# 和内容之间有一个 空格

分段

Markdown 的分段很简单,只需要用空行分隔,如果只是换行可以在行末尾插入两个空格。

列表

下面是无序列表的写法:

* 百度
* 腾讯
* 阿里巴巴

也可以这样写:

+ 微软
+ 谷歌
+ 苹果

也可以这样写:

- 中国工商银行
- 中国农业银行
- 中国建设银行

无序列表有3种写法,无论是哪一种写法最终的效果都是一样的,下面是无序列表的效果:

  • 百度
  • 腾讯
  • 阿里巴巴

下面是有序列表的写法:

1. 兰博基尼
2. 法拉利
3. 保时捷

注意 .和内容之间有空格,下面是有序列表的效果:

  1. 兰博基尼
  2. 法拉利
  3. 保时捷

链接

下面是链接的写法:

[百度](https://www.baidu.com)

在方括号内写链接名称,在普通括号内写链接地址,下面是链接的效果:

百度

图片

如果要在 Markdown 中插入图片需要先把图片上传到 Web 服务器或能直接使用公开地址访问的网络相册。

下面是插入图片的写法:

![百度Logo](https://www.baidu.com/img/bd_logo1.png?where=super)

以感叹号开头,注意!是英文模式的半角感叹号,在方括号内写图片描述。在正常情况下图片描述不会显示,只有在图片无法正常加载的情况下才会显示图片描述,在普通括号内写图片地址。

下面是图片效果:

百度Logo

分割线

下面是分割线的写法:

***

或者也可以这样写:

---

两种写法的效果是一样的,下面是分割线的效果:


引用

下面是引用的写法:

> 道路千万条,安全第一条。行车不规范,亲人两行泪。  

主要就是在段落开头加入一个 >,下面是引用的效果:

道路千万条,安全第一条。行车不规范,亲人两行泪。

粗体和斜体

下面是粗体的写法:

**粗体**

也可以这样写:

__粗体__

两种写法的效果都是一样的,下面是粗体的效果:

粗体

斜体的写法:

*斜体*

或者也可以这样写:

_斜体_

两种写法的效果也是一样的,下面是斜体的效果:

斜体

表格

感觉Markdown最不人性化的地方就是表格了,下面是表格的写法:

| 国产手机 | 国产汽车 | 国产飞机 |
| -------- | -------- | -------- |
| 华为     | 比亚迪   | C919     |
| 小米     | 长城     | ARJ21    |
| OPPO     | 奇瑞     | 新舟60   |

表头和主体之间用 - 分隔,列之间用 | 分隔,虽然看上去很直观,但是写起来也很麻烦,而且还不能合并单元格,感觉表格还不如HTML方便。
下面是表格效果:

国产手机国产汽车国产飞机
华为比亚迪C919
小米长城ARJ21
OPPO奇瑞新舟60

代码

代码使用 3个反引号包裹,下面是插入一段HTML的写法:

Markdown插入HTML

在反引号的后面可以加入语言名称,方便一些解析器解析,下面是HTML代码效果:

<div>
    <input type="name" value="表单" name="user">
</div>

注意!不同的解析器和网站呈现出的效果也会不一样,下面在插入一段PHP代码:

Markdown插入PHP代码

下面是效果:

<?php

echo "Hello Markdown";

如果要插入单行代码可以这样写:

PHP生成随机数的函数是 `mt_rand()`

最终效果如下:

PHP生成随机数的函数是 mt_rand()

转意符号

在Markdown中如果要输入一些和Markdown标记符相关的符号就需要用到转意符号,Markdown的转意符是 ** ,如果你想插入# 1,在不使用转意符的情况下会被识别未标题,如果在# 1的前面插入 就不会被识别为标题。

下面是转意符的写法:

\# 这不是标题  
\[这不是链接](https://www.misterma.com)  
\__这里的文字不会加粗__

下面是效果:

# 这不是标题
[这不是链接](https://www.misterma.com)
_这里的文字不会加粗_

注意!对于转意符不同的 Markdown 解析器解析的效果可能会不一样。

版权声明:本文为原创文章,版权归 Mr. Ma's Blog 所有,转载请联系博主获得授权!
本文地址:https://www.misterma.com/archives/446/
如果您对本文有什么问题或疑问都可以在评论区留言,我看到后会尽量解答。
最后编辑:2020年04月29日 ©著作权归作者所有

发表评论

正在加载 Emoji