MarkDown基本使用教程(学习笔记)

标题格式

MarkDown语法中可以通过 # 表示标题,一级标题对应一个 # 号,二级标题对应两个 # 号。也可以使用 = 和 - 标记一级和二级标题。

# 一级标题
## 二级标题
...

文本样式

通常文本两端用特殊符号包裹,中间不需要空格。以下是基本的文本语法:

  • 斜体文本( * 或者 _ )
    • *斜体文本*
  • 粗体文本(两个 * 或者 _ )
    • ***粗体文本**
  • 粗斜体文本( 三个* 或者 _ )
    • ***粗斜体文本***
  • 删除线 (两个~~)
    • ~~删除线~~
  • 下划线,使用标签包裹
    • 下划线
  • 添加脚注的格式:[^脚注名][1]
    • [^1]: 脚注释义

以下分割线可以直接用三个星号、减号、底线来建立一个分隔线,行内不能有其他内容。


列表

无序列表

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格,然后再填写内容。代码块与运行效果如下:

* 第一项
* 第二项
* 第三项
  • 第一项
  • 第二项
  • 第三项

有序列表

有序列表使用数字并加上 . 号来表示。代码块与运行效果如下:

1. 第一项
2. 第二项
3. 第三项
  1. 第一项
  2. 第二项
  3. 第三项

列表嵌套

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

1. 第一项:
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项:
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素
  1. 第一项:
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  2. 第二项:
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第二个元素

此处经过试验运行的结果表明子层列表受到外层列表的影响,外层是无序列表,子列表也是无序列表;外层是有序列表,子列表也是有序列表。(有些编辑器不受影响)

区块

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

> MarkDown
> 一个模块
>  > + 第一项
>  > + 第二项

MarkDown
一个模块

  • 第一项
  • 第二项

代码

如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`),例如:

`printf()` 函数

printf() 函数

代码区块
你也可以用 ```包裹一段代码,并指定一种语言(也可以不指定):

```代码块```

Markdown 链接

链接的使用方法:

[链接名称](链接地址)

或者

<链接地址>

也可以通过变量来设置一个链接,变量赋值在文档末尾进行:

通过变量来设置一个链接 [test][test]
[test]: http://www.baidu.com/

通过变量来设置一个链接 test

图片

Markdown 图片语法格式如下:

[图片上传失败...(image-1bf4ea-1595670630182)]

[图片上传失败...(image-bf6c-1595670630182)]

例如:

![测试图片](https://upload-images.jianshu.io/upload_images/20583109-5b0f0518dc0dc0e4.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

Markdown 还没有办法指定图片的高度与宽度,如果你需要的话,你可以使用普通的 标签。


Markdown 表格

Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
语法格式如下:

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

我们可以设置表格的对齐方式:

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐。
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

其它

  • 支持的 HTML 元素
  • 转义符 \

推荐:typora是比较不错的编写工具~


  1. 这个一个脚注。 ↩

你可能感兴趣的:(MarkDown基本使用教程(学习笔记))