Markdown语法

1. 概述

1.1设计理念

• Markdown易于阅读，方便用来创作Web文档，利于各平台无缝连接。
• Markdown语法灵感最大的来源还是email的格式，完全由标点符号标签组成的纯文本。
• Markdown文件应该以纯文本的形式原样发布，不应该包含标记标签和格式化指令。

1.2内联HTML语法

• HTML是一种发布格式，Markdown是一种创作模式。
• Markdown语法集合比较小，只是HTML标签的一部分。
• 对于Markdown中未包含的标签，可以直接使用HTML标签，例如HTML<a>标签替代Markdown的链接语法。

1.3特殊字符自动转义

在HTML中，有两个字符需要特殊对待：< 和 &,做尖括号用于起始标签。如果你想将他们做字面量，你必须将他们转义成字符实体，例如&lt和&amp。

2.行内语法讲解

2.1注释的表述

1. 代码法

<div style='display:none'>
哈哈哈我是注释，你看不见我！
</div>

2. html注释

<!--哈哈哈，你又看不见我！！！-->

3. hack方法
   • hack方法是利用啊markdown的解析原理来实现的注释的。
   • 一般有的markdown解释器不支持上面的注释方式，这个时候就可以用hack方法。
   • hack方法比上面两种方法稳定得多，但就是语义化太差

   [//]:#(哈哈哈哈，你看不见我的！！！)
   [^_^]:#(俺最萌了)
   [//]:<>(我是注释，你们都看不见我！)
   [comment]:<>(哈哈哈，你们看不见我！)
   

2.2分级标题、任务列表

1. 分级标题

#
##
###(最多六级)

2. 任务列表

- [ ] 任务一 未作任务
- [x] 任务二 已做任务

• 效果如下
  • 任务一 未作任务
  • 任务二 已做任务

2.3缩进、换行、空行、对齐方式

1. 首行缩进
   • 不同特殊占位符所占空白是不一样大的。

   【1】  或  //全角
   【2】  或  //半角
   【3】  或   //半角之半角
   

   【1】  或  //全角
   【2】  或  //半角
   【3】  或  //半角之半角
2. 换行：一般直接回车就可以
3. 空行：只有一个回车或者空格，那么就算是空行
4. 对齐方式：

   <center>行中心对齐</center>
   <p align="left">行左对齐</p>
   <p align="right">行右对齐</p>
   

   行中心对齐

   行左对齐

   行右对齐

2.4斜体、粗体、删除线、下划线、背景高亮

• 代码：

*斜体*或_斜体_
**粗体**或 __粗体__
*** 加粗斜体***
~~删除线~~
$\underline{下划线}$
==背景高亮==

• 显示效果
  斜体或 斜体
  粗体或 粗体
  *** 加粗斜体***
  删除线
  $\underline{下划线}$
  背景高亮

2.5 超链接、页内链接、自动链接、注脚

1. 超链接

   • 行内式
     [title](url)

   • 参考式

     我经常去的几个网站[Google][1]、[Leanote][2]。
     [1]:http://www.google.com
     [2]:http://www.leanote.com
     

     • 显示效果
       我经常去的几个网站Google、Leanote。

2. 页内超链接/锚点

   • 锚点：页面中，锚点其实就是页内超链接，也就是链接本文档内部的某些元素，实现当前页面中的跳转。比如我这来写下一个锚点，点击回到目录，就能跳转到目录。在目录中的点击这一节，就能跳过来。
   • 定义锚点，利用标签注释就可以<a id="index">超链接、页内链接、自动链接、注脚</a>
   • 建立页内连接一共两种方式，标签 和 markdown语法格式
   • 代码：

     跳转到[2.5超链接、页内链接、自动链接、注脚](#index)
     还可以这么跳<a href="#index">2.5超链接、页内链接、自动链接、注脚</a>
     

   • 显示效果：
     • 跳转到2.5超链接、页内链接、自动链接、注脚
     • 还可以这么跳2.5超链接、页内链接、自动链接、注脚

3. 自动链接

   • 语法说明：Markdown支持以比较简短的自动连接形式来处理网址和电子邮件信箱，只要用<>将其包起来就会自动转换为链接
   • 显示效果：<baidu.com>

4. 注脚

   • 语法说明：在需要添加注脚的文字后加上脚注名字[^注脚名字],称为脚注。然后在文本的任意位置（一般在最后）添加脚注，脚注前必须有对应的脚注名字。
   • 注意：经测试注脚与注脚之间必须空一行，不然会失效。
   • 代码展示

       使用Markdown[^1]可以高效的书写文档，直接转换成HTML[^2]
     
       [^1]:Markdown是一种纯文本标记语言
       [^2]:超文本标记语言
     

   • 效果展示
     使用Markdown¹可以高效的书写文档，直接转换成HTML²

2.6无序列表、有序列表、定义型列表

1. 无序列表：使用 + - * 表示无序列表
2. 有序列表：使用数字接着一个英文句号
3. 定义型列表：
   • 语法说明：定义行列表有名词和解释组成，一行写上定义，紧跟一行写上解释。解释的写法：紧跟一个缩进
   • 显示效果（不方便嵌套）：

Markdown

轻量级文本标记语言，可以转换为html,pdf等格式。（左侧有一个可见的冒号和四个不可见的空格）

2.7插入图像

• 可以使用<cdntre></centre>调整图片

2.8多级引用

• 语法说明：引用需要在被引用的文本前面加上 > 和空格
• 代码：

>>> hello1
>> hello2
> hello3

• 显示效果(感觉不到它的用处)

hello1

hello2

hello3

2.9转义字符、字体、字号、颜色

1. 转义字符：在需要转义的符号前加上 \
2. 字体、字号、颜色

• 代码

<font face="黑体">我是黑体字</font>
<font face="微软雅黑">我是微软雅黑</font>
<font face="STCAIYUN">我是华文彩云</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=gray size=5>gray</font>
<font color=#00ffff size=3>null</font>

• 显示效果

我是黑体字
我是微软雅黑
我是华文彩云

黑体
gray
null

3.语法块讲解

3.1内容目录

• 在段落中填写[TOC]以显示全文内容的目录结构。

3.2代码块

• 插入程序代码的方式有两种：一种是利用缩进；另一种是利用 ` 符号包裹代码

1. 行内式：C语言里面的printf()函数
2. 缩进式多行代码：
   #include<stdio.h>
   int main()
   {
   printf(“Hello world!”);
   return 0;
   }
3. 用六个 ` 包裹多行代码

3.3流程图

3.3.1 横向流程图源码格式

3.3.2竖向流程图

3.3.3标准流程图

• 语法：
  • 定义元素
    • 语法格式：tag => type: content :>url**type:后面必须有空格隔开
    • tag:元素名称
    • type:元素类型
      • start：开始
      • end:结束
      • operation:操作
      • subroutine:子程序
      • condition:条件
      • inputoutput:输入输出
    • content:元素内容，注意type后的冒号与文本之间要有空格
    • url:元素超链接，与content元素内容绑定
  • 连接元素：
    • 通过 -> 连接元素就会正确显示出来
    • 注意condition需要yes 和 no两个分支，需要分别连接
  • 注意：如果报错很可能是type拼写错误或者 冒号后缺少空格

3.3.4标准流程图源码格式（横向）

3.3.5UML时序图源码

• 注意:凡是里面用到的代表格式意义的冒号都要用英文格式下的

3.3.6UML时序图源码复杂样例

3.3.7UML标准时序图样例

3.3.8甘特图样例

3.4表格

语法说明

• 不管哪种方式,第一行为表头，第二行分割表头和主体部分，第三行开始每一行为一个表格行。

• 第二行还可以为不同的列指定对齐方向。默认为左对齐

  -	:-:	-:
  左对齐	中心对齐	右对齐

3.5LaTex公式

1. 表示行内公式

质能守衡方程可以用一个很简洁的方程式$E=mc^2$来表达

• 质能守衡方程可以用一个很简洁的方程式$E=m{c}^2$来表达

2. 表示整行公式

E=mc^2

3.6分割线

• 语法：你可以在一行中使用三个以上的星号、减号、底线来建立一个分割线。

3.7HTML源码

• 在代码区块里面，&、<和>会自动转化成HTML实体，这样非常容易在Markdown插入范例用的HTML原始码，只要复制贴上，剩下的Markdown都会帮你处理

---

1. Markdown是一种纯文本标记语言 ↩︎

2. 超文本标记语言 ↩︎