Markdown格式说明

Markdown支持段落、换行、代码、列表、链接、图片和纯html

md格式说明:md(Markdown,下文简称md格式),一种普通的文本标记语言,源自电子邮件格式,是网络书写语言。它的特点是易于人阅读、兼容html标签、特殊字符自动转换、多系统兼容。

段落和换行

md格式的段落采用 前后空行 表示。

一些内容……

这个前后空行的文字将被解释为段落

另外的内容……

一段文字如果前后有空行,则自动转换为html的段落。注意中文段落首字缩进应该设置段落的css样式:使用空格或者tab开始的文字将被转换为代码块,所以文字都是顶头书写的。

p{
    text-indent:2em;
}  

md格式的换行采用在 结尾加两个(以上)空格 表示。

标题

md格式的标题采用”###“表示,几个” # “就是几级,中间加一个空格。

# 这个是一级标题 --> <h1>这个是一级标题</h1>
## 二级标题 ……
### 三级标题 ……
#### 四级标题 ……
##### 五级标题 --> <h5>五级标题</h5>

引用

md的引用采用” > “表示,它加在行首或段落首,不用空格,支持多行和嵌套。

>这个是一段引用文字。

注意:引用会将文字转换为“blockquote”标签,其样式一样的可以在css文件中定义,比如本段文字这个样子就是一段引用。

引用的东西也可以有其他格式,比如标题、代码块:

标题

  <blockquote>这个是html代码</blockquote>
  1. 这是第一行列表项。
  2. 这是第二行列表项。

最后嵌套一个引用

列表

无序列表前加星号“ * ”或者加号“ + ”或者减号“ - ”,中间加上空格。

* 第一个星号的无序列表
+ 第二个加号的列表
- 第三个减号的列表

结果如下:

  • 第一个星号的无序列表
  • 第二个加号的列表
  • 第三个减号的列表

有序列表采用数字加点“ . ”表示,数字与结果无关,中间加空格

1. 这个是有序列表
2. 这个是第二项
400. 这个是第三项,故意写错的序号“400”

结果是:

  1. 这个是有序列表
  2. 这个是第二项
  3. 这个是第三项,故意写错的序号“400”被纠正为“3”

列表采用空行,就会变成一段(几段)组成的一个列表:

+ 这个是一段

+ 这个是另外一段

结果是:

  • 这个是一段

  • 这个是另外一段

如果要让段落、引用、代码等同处于列表中,需要给他们首行开始的四个空格(或者一个tab)的缩进:

+ 这个是第一个项目的第一段

    这个组成第一个的第二段,但是首字母要缩进呢!

+ 这个是第二个项目

    >这个是第二个项目里面的引用

结果是:

  • 这个是第一个项目的第一段

    这个组成第一个的第二段,但是首字母要缩进呢!

  • 这个是第二个项目

    这个是第二个项目里面的引用

在md的官方文档中提及到了文本中的句号“.”的问题,比如一个数字加上“.”并空格后会被转义为有序列表,咱是中文咱不怕,咱的句号是“。”。当然,非得出现的时候,您可以使用“\.“来告诉转换程序这个是点不是列表!

代码块

代码块采用 四个空格或一个tab 表示。

<div class="footer">
    ©2014-2018 zimustudio.com
</div>

文字中的html代码都会被转义,而且阅读性不好,建议都使用代码块表示,因为代码也是要格式才能阅读的。

分割线

分割线采用 三个 以上的”*“或”-“或”_“表示。

---
一些内容
***
另一些内容
___

结果:


一些内容


另一些内容


链接

链接采用 方括号 写文字, 圆括号 写地址(和标题)的方式,标题在圆括号内用 引号 表示。

[字母-原创设计技术](http://www.zimustudio.com "字母-原创设计技术") 

结果:字母-原创设计技术

在hugo里面,链接会自动生成:只要带“http:”或者用尖括号包裹:http://www.zimustudio.com。

强调

采用前后加星号“*”或下划线“”的方式产生em的强调,如果是两个“*”或”“则是strong强调。中文的注意前后要加空格

这个是 *星号* 的em强调
这个是 __下划线__ 的strong强调

结果是:
这个是 星号 的em强调
这个是 下划线 的strong强调

*这是一段的强调,如果要在开始和结束使用“”,必须转义它

图片

在链接的方法中,方括号前面加上”!”就是图片了

![这是个图片](/img/hugo/hugo.png)

这是个图片

高级

未完待续……