Markdown简明语法教程

Posted by Steve on March 19, 2018

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日:初稿。