180915:发现了一个貌似很全的介绍markdown语法的网站
显示效果以“MarkdownPad 2”为准,貌似不同的引擎解析起来的效果略有区别。
此篇文章旨在列举常用的markdown语法,方便新手快速入门。以下简称md。
md是什么在这里就不多谈了,但是它真的很方便。 写一些项目的帮助文档或者教程笔记的时候,可以保持对内容的专注的情况下,很方便的用md生成比较漂亮的页面。 而且平时整理自己的摄影“作品”的时候,会想对其描述一番,这时候使用就可以很方便的生成html来展示图片,同时又有描述。
基本介绍
01.文本的基本格式
- 在md中,回车后不会分段。只是有一个Tab的间隔。两次回车后才会有间隔,及段落之间要有空行。
- 斜体是用2个“*”包裹的文本。
- 粗体是用4个“*”包裹的文本,左右各2个。
- 既斜又粗是用6个“*”包裹的文本,左右各3个。
-
利用背景色来重点标识关键字,是用2个“`”包裹的文本。 -
删除线来表示删除,文字两侧都用”~~”来包围即可。
02.标题的使用,即“#”号的使用
“#”用来作为标题来区分段落,有点像html中的h1 h2 h3… 注意“#”和后面的标题文本要有一个空格来进行间隔。
- 最多支持6个“#”号,依次缩小。
- 2个“#”号的时候,在标题下面会有横线
- 6个“#”号的时候,标题会变成灰色。
03.链接图片、网址、文档
下面说明的是正常链接的方式,实际也将文本和链接分开。将这段文字写在文章的最下面来同一管理,页面也不会有显示的。
[Git 官网]:https://git-scm.com/
03.01 链接图片
链接图片包含两种形式,一种是将图片以超链接的形式嵌入到文本当中。点击文本后页面跳转到上。另一种是像下面一样将图片嵌入在页面中。

- 前者:
[文本](图片文件的路径,默认是以当前路径来查找) - 后者:

03.02 链接网址
链接网址和链接图片类似。一种是超链接嵌入到文本中。另一种是以可以点击的的链接https://www.baidu.com的形式表示。
- 前者:
[文本](https://www.baidu.com) - 后者:
<https://www.baidu.com>
03.03 链接文档
其实链接文档和上面的图片以及网址是一样的,下载 zip。
04.普通无序列表
用“-”、“+”、“*”来标识列表即可,文字和符号之间有一个空格。
更新日志
- 2018年03月19日:初稿。