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

标题格式

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

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

文本样式

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

  • 斜体文本( * 或者 _ )
    • *斜体文本*
  • 粗体文本(两个 * 或者 _ )
    • ***粗体文本**
  • 粗斜体文本( 三个* 或者 _ )
    • ***粗斜体文本***
  • 删除线 (两个~~)
    • ~~删除线~~
  • <u>下划线</u>,使用<u>标签包裹
    • <u>下划线</u>
  • 添加脚注的格式:[^脚注名][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 还没有办法指定图片的高度与宽度,如果你需要的话,你可以使用普通的 <img> 标签。

<img src="https://qiniuimage.hulianjun.com/test/logo.png" width="20%"/>

<img src="https://qiniuimage.hulianjun.com/test/logo.png" width="20%"/>

Markdown 表格

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

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

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

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

其它

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

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


  1. 这个一个脚注。

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

推荐阅读更多精彩内容

  • 教程地址:Markdown教程 | 菜鸟教程 Markdown 介绍 Markdown 是一种轻量级标记语言,它允...
    LCode丶阅读 1,696评论 0 0
  • 1. 什么是Markdown? Markdown 是一种非常简单的、轻量级的标记语言。用户可以使用简单的标记符号以...
    胡諾阅读 3,505评论 0 0
  • 一、标题 标题的表示一共有两种方法: 使用多个#号加空格开头一行的标题,#号数量代表标题的等级。以此类推最多六级。...
    Leib_Niz阅读 3,290评论 0 1
  • Markdown 语法学习 标题 Markdown文字格式及段落 斜体 粗体 删除线 下划线 粗斜文本 今天下雨了...
    MaginaDai阅读 2,394评论 0 3
  • Markdown学习 Markdown标题 Markdown标题有两种格式。 使用=和-标记一级和二级标题 使用#...
    三尺青锋Vince阅读 2,206评论 0 0