Fork me on GitHub Markdown语法简要 - 冰路梦 | binglumeng
Markdown

Markdown语法简要

Posted by 冰路梦 on 2016-10-27

Markdown语法简要

  • Markdown语法简要
    - [1. 标题](#1-标题)
- [2. 区块引用](#2-区块引用)
- [3. 分割线](#3-分割线)
- [4. 背景框](#4-背景框)

####1. 标题

  • #标题，1–6级别，atx风格，效果：

    标题6

  • =或-似乎只有一个级别，setext风格，效果

    标题
===<font color="#ff0000">**csdn不支持**</font>

2. 区块引用

>行首位置,可嵌套，效果：

段落引用块

内部嵌套

####3. 分割线
分割线用 ---、___和***三个加、减、下划线，注意不要和标题的一种形式混淆。效果：

####4. 背景框

```反引号构成背景框。效果，`背景框`
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
####5. 列表
有无和无序。
- `-`、`+`、`*`符号位于行首，紧跟空格。有序列表只是用数字替代前述符号，数字不要求有序。效果：
- 无序列
   6. 有序
   7. 有序
####6. 代码块
   `使用三对反引号```java  ```从行首起，中间写代码，可在三引号后声明代码语言，实现高亮`，效果：
```java
	public void test(){
	//注释
	}

####7. 链接

####8. 强调

  • 使用一对**或__表示强调，被强调文本在其中。一对**或__是斜体

    两对是粗体，三对是斜体加粗。效果：
    斜体，粗体，粗斜体

  • 两对~~~~表示删除线，包裹文本。

    效果：删除

  • 两对====之间高亮

    效果：==高亮==

  • <u></u>之间下划线

    效果：下划线

9. 符号

参照第18条，其实用于数学公式更多。

一对$$符号，文本其中可以斜体，两对$$$$文本其中，居中斜体。还会有编号。(刚明白，是数学公式常用。)

  • 在$$或$$$$之中的文本，其首尾处有~产生空格；

  • 文本首尾有#、{、}、&会出现黑色边框，且包含前述符号。

    • ^、_在文本尾部效果如上，在起始出，则分别表示上下角标。

    • %隐藏%号后面内容。

      \符号可以转义其他符号。自定义的标签<info>之类可能被隐藏。
      效果：
      一对美元符号：$one$
      两对美元符号：$$two$$
      带边框：$frame_$
      上角标：$^up$，下角标$_low$
      隐藏：$注意百分号后面%没有了$
      $注意百分号后面%没有了$
      ####10. 图片

      类似链接，行内式和参考式

  • 行内式，![name](path)

  • 参考式，![name][image]，id定义其他地方[image]:image\path
    • 效果：img
    • githubj

####11. 表格

行首开始，写title，`|`符号表示分栏，减号`-`表示列宽。格式为首行写title，次行写对齐方式。至少形成表头才是表格。两列一行。

1
2
3
学号|姓名
-|
有的必须每行前后都要有|符号

  • :---左对齐

  • ---:右对齐

  • :---:居中

  • ---默认对齐方式，左对齐。

  • 效果：第二列只有两个|也能分三栏

    ​

    | 学号 | 姓名 | 成绩 |
    | —- | —- | —- |
    | | | |

    ​

12. 复选框

使用列表的符号，加减星，或数字，配合空格、x、和[ ]符号

1
格式为`+或-或*`空格`[空格或x]`空格，列表内容。其中x、X都行。

效果：

  • [ ] 第一项
  • [x] 第二项

13. 表情符号

格式，一对`::`中加emoji英文代码，如:monkey:，[emoji](http://emoji.codes)

:monkey:,:star:,:girl:

####14. 脚注

格式`[^id]`符号，文章尾或其他处声明。`[^id]:注解`
效果：脚注[^footer]

####15. 目录

格式，`[toc]`符号，效果见文章目录。

16. UML类图

格式，类似代码块，三反引号`    
```       `声明sequence后，单行写交互语句。
1
2
3
4
5
6
​    
    ​```A->B:hello//A对B
    note left of B:what?//B思考,
    B-->A:ok//B回复A，虚线。
    ​



效果：

1
2
3
A->B: hello
Note right of B: what?
B-->A:ok

17.流程图：

类似UML图，语言标签为`flow`，用`=>`表路线，有对应代码标识。以后在慢慢整理，`先定义标签再使用操作？`

​
1
2
3
4
5
6
7
8
9
  ```flow
  st=>start: 开始
  e=>end: 结束
  op=>operation: 我的操作
  cond=>condition: 确认？
  st->op->cond
  cond(yes)->e
  cond(no)->op
​


​
1
2
3
4
5
6
7
8
9
10
11
效果：
```flow
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认？
st->op->cond
cond(yes)->e
cond(no)->op

18. 甘特图：

类似代码块，语言标识`gantt`，有语法，以后慢慢总结。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
​```gantt
    title 项目开发流程//标题
    section 项目确定//项目阶段
        需求分析       :a1, 2016-06-22, 3d//任务名称，日期线和时长
        可行性报告     :after a1, 5d
        概念验证       : 5d
    section 项目实施
        概要设计      :2016-07-05  , 5d
        详细设计      :2016-07-08, 10d
        编码          :2016-07-15, 10d
        测试          :2016-07-22, 5d
    section 发布验收
        发布: 2d
        验收: 3d
​
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
```gantt
	title 项目开发流程
        section 项目确定
            需求分析       :a1, 2016-06-22, 3d
            可行性报告     :after a1, 5d
            概念验证       : 5d
        section 项目实施
            概要设计      :2016-07-05  , 5d
            详细设计      :2016-07-08, 10d
            编码          :2016-07-15, 10d
            测试          :2016-07-22, 5d
        section 发布验收
            发布: 2d
            验收: 3d

19. 数学公式：

markdown多使用LaTex数学公式，用`$`和`$$`符号标识
  • 行内公式，$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$

效果：$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$

  • 块级公式，$$x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

效果：$$x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

附注：本文所列举markdown语法，适合大部分markdown编辑器，仍有个别功能属增强功能，读者请留心。
注意：各个语法效果之间，需要有空行，避免相互干扰。（有的编辑器会自动给你处理，有的却不会。）

附上较详细的markdown语法文本

FEATURED TAGS
Markdown
FRIENDS