markdown基础

标题

使用 # 号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。

文本及字体

    *斜体文本*
    _斜体文本_
    **粗体文本**
    __粗体文本__
    ***粗斜体文本***
    ___粗斜体文本___

效果如下:

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

有序列表和无序列表

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

选择框

- [x] aa
- [ ] bb

显示效果如下:

  • aa
  • bb

链接和图片链接

  1. 链接使用方法如下:
[链接名称](链接地址)
例如:
这是一个链接 [菜鸟教程](https://www.runoob.com)

显示如下:
这是一个链接 菜鸟教程

  1. Markdown 图片链接如下:
![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")
例如:
![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png)
![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png "RUNOOB")

显示如下:
[图片上传失败...(image-2496c9-1640918580663)]
[图片上传失败...(image-8b65d3-1640918580663)]

代码和区块引用

  1. Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号:
    例如:
> 区块引用
> 菜鸟教程
> 学的不仅是技术更是梦想

显示如下:

区块引用
菜鸟教程
学的不仅是技术更是梦想

  1. 代码
    • 如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`),
    • 代码区块使用 4 个空格或者一个制表符(Tab 键)。
    • 代码区块也可以用 ``` 包裹一段代码,并指定一种语言(也可以不指定)

例如:

`printf()` 函数

``` javascript
$(document).ready(function () {
alert('RUNOOB');
});
```

显示如下:
printf() 函数

$(document).ready(function () {
    alert('RUNOOB');
});

表格

Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
对齐方式,我们可以设置表格的对齐方式:
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。
例如1:

|  表头   | 表头  |
|  -  | -  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

显示如下1:

表头 表头
单元格 单元格
单元格 单元格

例如2:

| 左对齐 | 右对齐 | 居中对齐 |
| :-| -: | :-: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

显示如下2:

左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

转义

Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:
例如:

**文本加粗** 
\*\* 正常显示星号 \*\*

显示如下:
文本加粗
** 正常显示星号 **

流程图、时序图(顺序图)、甘特图

  1. 形状
    例如1:

``` mermaid
graph TD
id1[矩形]
id2(圆角矩形)
id3>不对称的矩形]
id4{菱形}
id5((圆形))
```
显示如下1:

graph TD
    id1[矩形]
    id2(圆角矩形)
    id3>不对称的矩形]
    id4{菱形}
    id5((圆形))

例如2:

``` mermaid
graph
id1{菱形}
id2{{六角形}}
id3[/平行四边形/]
id4[\反向平行四边形]
id5[/梯形]
id6[\反向梯形/]
```

显示如下2:

graph
    id1{菱形}
    id2{{六角形}}
    id3[/平行四边形/]
    id4[\反向平行四边形\]
    id5[/梯形\]
    id6[\反向梯形/]
  1. 方向:用于开头,声明流程图的方向。
    graph或graph TB或graph TD:从上往下
    graph BT:从下往上
    graph LR:从左往右
    graph RL:从右往左

  2. 连线形式

  • 直链
graph LR
   A -- text --> B -- text2 --> C

显示如下:

graph LR
   A -- text --> B -- text2 --> C
  • 多重链:可以使用&字符,或单个描述
graph 
   a --> b & c--> d
   
   A & B--> C & D
   
    X --> M
    X --> N
    Y --> M
    Y --> N

显示如下:

graph 
   a --> b & c--> d
   
   A & B--> C & D
   
    X --> M
    X --> N
    Y --> M
    Y --> N
  1. 连线样式
    实线箭头:分为无文本箭头和有文本箭头,有文本箭头有2种书写格式
graph LR
a-->b--文本1-->c-->|文本2|d

显示如下:

graph LR
a-->b--文本1-->c-->|文本2|d

粗实线箭头:分为无文本箭头和有文本箭头

graph LR
a==>b==文本==>c

显示如下:

graph LR
a==>b==文本==>c

虚线箭头:分为无文本箭头和有文本箭头

graph LR
a-.->b-.文本.->c

显示如下:

graph LR
a-.->b-.文本.->c

无箭头线:即以上三种连线去掉箭头后的形式
其他连线:需要将graph关键字改为flowchart
延长连线:增加相应字符即可,如下图中的B到E,连线中增加了一个-。字符可多次添加。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 链接语法 链接 文本 放在 中括号 [ ] 内,链接 地址 放在后面的 小括号( ) 中,链接t...
    不务正业幽大人阅读 4,717评论 0 0
  • 1. Markdown 前提说明 使用工具 Visual Studio Code 使用的插件:1. Markdow...
    Machelle_阅读 5,691评论 0 0
  • 1. 简述 Markdown是一种易读易写的纯文本标记语言,能够实现使用少量标记符号以最小的输入代价生成极富表现力...
    胡博麟阅读 3,899评论 0 1
  • 因为在简书上写文章需要使用到MarkDown,但是我对MarkDown语法不熟,所以写下这一篇《MarkDown ...
    _执念__阅读 3,526评论 0 1
  • 简单整理了些常用的markdown语法,方便大家用的时候查询 标题 语法 这是1级案例 这是二级案例 引用 语法 ...
    MA木易YA阅读 3,418评论 0 4