什么是Markdown?

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。

Markdown 语言在 2004 由约翰·格鲁伯（John Gruber）创建。

Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。

使用Markdown语法演示

下面看一下效果如何:

标签

tag tag2

斜体

斜体字 斜体字2

加粗

加粗字 加粗字2

删除

删除线

块引用

块引用效果

1. 第一项

• 第二项

第二层嵌套

第三层嵌套

文本脚注(页面底部)

要注明的文本脚注 ¹

不换行

定义一行 (后面加两个空格换行) 换行了-

链接

Blog

图片

定义类列表

标题1

列表a

列表b

标题2

列表c

列表d

数组列表

1. 一列
2. 二列
3. 三列
   1. 三列1
   2. 三列2
   3. 三列3

无序列表

• 星号1(*)
• 星号2(*)

• 加号1(+)
• 加号2(+)

• 减号1(-)
• 减号2(-)

或者

• 一级列表
• 如果您有子列表，请在破折号或星号前放置两个空格:
  • 二级列表
  • 二级列表

标题效果

h1效果 （== =）

h2效果（- - -）

h3效果

h4效果

h5效果

h6效果

分割线 (* * * )

表格效果

复选框效果

• 被选中
• 没选中

语法高亮

function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}

代码区块使用 4 个空格或者一个制表符 (Tab 键)

Emoji表情

显示效果参考：https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md

画图

当然还有 typora、画流程图、时序图(顺序图)、甘特图 等等…

Hugo 简码 (shortcodes)

images 简码

notices 简码

badge 简码

更多效果及详细源代码请查阅：php_badge

Hugo内置简码

1. figure 是markdown中图像语法的扩展，没有为更具语义的HTML5<figure>元素提供简写。

2. gist 博客作者在撰写帖子时通常希望包括GitHub要点

{+{< gist spf13 7896402 >}+}

3. highlight 该短代码会将提供的源代码转换为语法突出显示的HTML

<section id="main">
  <div>
   <h1 id="title">{{ .Title }}</h1>
    {{ range .Pages }}
        {{ .Render "summary"}}
    {{ end }}
  </div>
</section>

4. instagram 如果您想嵌入来自Instagram的照片，则只需要照片的ID(需要梯子)

{+{< instagram BWNjjyYFxVx >}+}

{+{ < instagram BWNjjyYFxVx hidecaption > }+} 隐藏标题

5. param 从Page设置的当前参数中获取值，并回退到站点参数值。ERROR 如果在任何一个中都找不到带有给定键的参数，它将记录一个。

{+{< param title >}+}

6. ref和relref 标准的Hugo地址

ref: https://yake.tk/author.html

relref: /author.html#who

7. tweet 您想在您的博客文章中添加一条推文吗(需要梯子)

{+{< tweet 877500564405444608 >}+}

8. vimeo 从Vimeo添加视频等同于YouTube输入简码(需要梯子)

{+{< vimeo 146022717 >}+}

9. youtube 该简码嵌入一个响应视频播放YouTube视频。只需要视频的ID(需要梯子)

{+{< youtube w7Ft2ymGmfc >}+}