Markdown语法学习

alt 测试

这个链接用 1 作为网址变量 RUNOOB.
然后在文档的结尾为变量赋值(网址)

图片的两种方式:

  • ```markdown
    alt 图片显示失败
    1
    2
    3

    - ```html
    <img src="http://static.runoob.com/images/runoob-logo.png" width="50%"> 可以指定图片高度

链接的两种方式:

代码方式:

  • `printf()`函数
    
    1
    2
    3
    4
    5

    - ```markdown
    ```java
    System.out.println("可以用 ``` 包裹一段代码,并指定一种语言(也可以不指定)")
    ​```
  • 代码区块使用 4 个空格或者一个制表符(Tab 键)
    
    1
    2
    3
    4
    5
    6
    7
    8
    9

    ### 区块:

    Markdown 区块引用是在段落开头使用 **>** 符号 ,然后后面紧跟一个**空格**符号

    - ```markdown
    > 区块引用
    > 菜鸟教程
    > 学技术
    > 区块引用 > 菜鸟教程 > 学技术
  • ```

    最外层

    第一层嵌套

    第二层嵌套

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15

    > 最外层
    > > 第一层嵌套
    > >
    > > > 第二层嵌套

    ##### 区块中使用列表

    ```markdown
    > 区块中使用列表
    > 1. 第一项
    > 2. 第二项
    > + 第一项
    > + 第二项
    > + 第三项

区块中使用列表

  1. 第一项
  2. 第二项
  • 第一项
  • 第二项
  • 第三项
列表中使用区块
1
2
3
4
* 第一项
> 菜鸟教程
> 学的不仅是技术更是梦想
* 第二项
  • 第一项

    菜鸟教程
    学的不仅是技术更是梦想

  • 第二项

Markdown列表

Markdown 支持有序列表和无序列表。

无序列表使用星号(****)、加号(+)或是减号(*-**)作为列表标记,这些标记后面要添加一个空格,然后再填写内容:

1
2
3
4
5
6
7
8
9
10
11
12
* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项


- 第一项
- 第二项
- 第三项
  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项

有序列表使用数字加上.号来表示:

1
2
3
1. 第一项
2. 第二项
3. 第三项
  1. 第一项
  2. 第二项
  3. 第三项
列表嵌套

列表嵌套只需在子列表中的选项前面添加4个空格即可:

1
2
3
4
5
6
1. 第一项
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个原素
2. 第二项
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个原素
  1. 第一项
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个原素
  2. 第二项
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第二个原素

Markdown段落

Markdown段落没有特殊的格式,直接编写文字就好,段落的换行是使用两个以上空格加上回车

1
2
第一段  
第二段

第一段
第二段

字体

Markdown可以使用一下几种字体:(一斜二粗三斜粗)

1
2
3
4
5
6
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

斜体文本

斜体文本

粗体文本
粗体文本
粗斜体文本
粗斜体文本

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

1
2
3
4
5
6
7
8
9
***

* * *

*****

- - -

----------





删除线

如果段落上的文字要加上删除线,只需在文字的两端加上两个~~即可:

1
2
3
中国
俄罗斯
~~日本~~

中国
俄罗斯
日本

下划线

下划线通过HTML的<u>标签来实现:

1
<u>下划线文本</u>

下划线文本

脚注

Markdown 脚注的格式如下:

1
[^要注明的文本]
1
2
3
创建脚注格式类似这样 [^RUNOOB]。

[^RUNOOB]: 菜鸟教程 -- 学的不仅是技术,更是梦想!!!

创建脚注格式类似这样 [^RUNOOB]。

[^RUNOOB]: 菜鸟教程 – 学的不仅是技术,更是梦想!!!

Markdown标题

两种方式:

  • ```markdown
    使用=- 标记一级和二级标题
    1
    2
    3

    - ```markdown
    使用 `#` 标记,可表示1-6级标题,一级标题对应一个`#`号,二级标题对应两个 `#` 号

Markdown表格

Markdown使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。

1
2
3
4
| 表头1 | 表头2 |
| ---- | ---- |
| 单元格1| 单元格2 |
| 单元格3| 单元格4 |
表头1 表头2
单元格1 单元格2
单元格3 单元格4

对齐方式

  • -: 设置内容和标题栏居右对齐

  • :- 设置内容和标题栏居右对齐

  • :-: 设置内容和标题栏居中对齐

表头1 表头2
单元格1 单元格2
单元格3 单元格4

高级使用技巧

  1. 横向流程图:

    1
    2
    3
    4
    5
    6
    7
    8
    ```mermaid
    graph LR
    A[方形] -->B(圆角)
    B --> C{条件a}
    C -->|a=1| D[结果1]
    C -->|a=2| E[结果2]
    F[横向流程图]
    ​```
    1
    2
    3
    4
    5
    6
    graph LR
    A[方形] -->B(圆角)
    B --> C{条件a}
    C -->|a=1| D[结果1]
    C -->|a=2| E[结果2]
    F[横向流程图]
  2. 竖向流程图

    1
    2
    3
    4
    5
    6
    7
    8
    ```mermaid
    graph TD
    A[方形] --> B(圆角)
    B --> C{条件a}
    C --> |a=1| D[结果1]
    C --> |a=2| E[结果2]
    F[竖向流程图]
    ​```
1
2
3
4
5
6
graph TD
A[方形] --> B(圆角)
B --> C{条件a}
C --> |a=1| D[结果1]
C --> |a=2| E[结果2]
F[竖向流程图]
  1. 标准流程图

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    ```flow
    st=>start: 开始框
    op=>operation: 处理框
    cond=>condition: 判断框(是或否?)
    sub1=>subroutine: 子流程
    io=>inputoutput: 输入输出框
    e=>end: 结束框
    st->op->cond
    cond(yes)->io->e
    cond(no)->sub1(right)->op
    ​```
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    ```flow
    st=>start: 开始框
    op=>operation: 处理框
    cond=>condition: 判断框(是或否?)
    sub1=>subroutine: 子流程
    io=>inputoutput: 输入输出框
    e=>end: 结束框
    st->op->cond
    cond(yes)->io->e
    cond(no)->sub1(right)->op
    ​```
  2. 标准流程图(横向)

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    ```flow
    st=>start: 开始框
    op=>operation: 处理框
    cond=>condition: 判断框(是或否?)
    sub1=>subroutine: 子流程
    io=>inputoutput: 输入输出框
    e=>end: 结束框
    st(right)->op(right)->cond
    cond(yes)->io(bottom)->e
    cond(no)->sub1(right)->op
    ​```
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    ```
    st=>start: 开始框
    op=>operation: 处理框
    cond=>condition: 判断框(是或否?)
    sub1=>subroutine: 子流程
    io=>inputoutput: 输入输出框
    e=>end: 结束框
    st(right)->op(right)->cond
    cond(yes)->io(bottom)->e
    cond(no)->sub1(right)->op
    ```
  3. UML时序图

    1
    2
    3
    4
    5
    6
    7
    ```sequence
    对象A->对象B: 对象B你好吗?(请求)
    Note right of 对象B: 对象B的描述
    Note left of 对象A: 对象A的描述(提示)
    对象B-->对象A: 我很好(响应)
    对象A->对象B: 你真的好吗?
    ​```
    1
    2
    3
    4
    5
    对象A->对象B: 对象B你好吗?(请求)
    Note right of 对象B: 对象B的描述
    Note left of 对象A: 对象A的描述(提示)
    对象B-->对象A: 我很好(响应)
    对象A->对象B: 你真的好吗?
  4. UML时序图复杂样例

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    ```sequence
    Title: 标题:复杂使用
    对象A->对象B: 对象B你好吗?(请求)
    Note right of 对象B: 对象B的描述
    Note left of 对象A: 对象A的描述(提示)
    对象B-->对象A: 我很好(响应)
    对象B->小三: 你好吗
    小三-->>对象A: 对象B找我了
    对象A->对象B: 你真的好吗?
    Note over 小三,对象B: 我们是朋友
    participant C
    Note right of C: 没人陪我玩
    ​```
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    Title: 标题:复杂使用
    对象A->对象B: 对象B你好吗?(请求)
    Note right of 对象B: 对象B的描述
    Note left of 对象A: 对象A的描述(提示)
    对象B-->对象A: 我很好(响应)
    对象B->小三: 你好吗
    小三-->>对象A: 对象B找我了
    对象A->对象B: 你真的好吗?
    Note over 小三,对象B: 我们是朋友
    participant C
    Note right of C: 没人陪我玩
  5. UML标准时序图样例

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    ```mermaid
    %% 时序图例子,-> 直线,-->虚线,->>实线箭头
    sequenceDiagram
    participant 张三
    participant 李四
    张三->王五: 王五你好吗?
    loop 健康检查
    王五->王五: 与疾病战斗
    end
    Note right of 王五: 合理 食物 <br/>看医生...
    李四-->>张三: 很好!
    王五->李四: 你怎么样?
    李四-->王五: 很好!
    ​```
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    %% 时序图例子,-> 直线,-->虚线,->>实线箭头
    sequenceDiagram
    participant 张三
    participant 李四
    张三->王五: 王五你好吗?
    loop 健康检查
    王五->王五: 与疾病战斗
    end
    Note right of 王五: 合理 食物 <br/>看医生...
    李四-->>张三: 很好!
    王五->李四: 你怎么样?
    李四-->王五: 很好!
  6. 甘特图样例

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    ```mermaid
    %% 语法示例
    gantt
    dateFormat YYYY-MM-DD
    title 软件开发甘特图
    section 设计
    需求 :done, des1, 2014-01-06,2014-01-08
    原型 :active, des2, 2014-01-09, 3d
    UI设计 : des3, after des2, 5d
    未来任务 : des4, after des3, 5d
    section 开发
    学习准备理解需求 :crit, done, 2014-01-06,24h
    设计框架 :crit, done, after des2, 2d
    开发 :crit, active, 3d
    未来任务 :crit, 5d
    耍 :2d
    section 测试
    功能测试 :active, a1, after des3, 3d
    压力测试 :after a1 , 20h
    测试报告 : 48h
    ​```
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    %% 语法示例
    gantt
    dateFormat YYYY-MM-DD
    title 软件开发甘特图
    section 设计
    需求 :done, des1, 2014-01-06,2014-01-08
    原型 :active, des2, 2014-01-09, 3d
    UI设计 : des3, after des2, 5d
    未来任务 : des4, after des3, 5d
    section 开发
    学习准备理解需求 :crit, done, 2014-01-06,24h
    设计框架 :crit, done, after des2, 2d
    开发 :crit, active, 3d
    未来任务 :crit, 5d
    耍 :2d
    section 测试
    功能测试 :active, a1, after des3, 3d
    压力测试 :after a1 , 20h
    测试报告 : 48h