Markdown语法大全

基本语法的介绍及使用方法

Posted by 陈十二 on Thursday, November 3, 2022

简介

Markdown是一种轻量级、易读易写的标记语言,为简单而生,没有花里胡哨的操作,因此被广泛应用,以.md/.markdown文档格式保存。

语法介绍及使用

直接进入正题,以下我将介绍Markdown的基本语法和使用教程。

标题

Markdown的标题有两种格式。

1. 使用 = 和 - 标记

注:此格式只能标记一级标题和二级标题。 标题格式一

2. 使用 # 号标记

注:此标记可表示1-6级标题。 标题格式二

段落

1. 字体

Markdown支持三种字体,分别为斜体、粗体和粗斜体

格式:

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

效果:

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

2. 换行

使用两个以上的空格+一个回车,即可实现换行。若使用 两个回车,则表示重新开始一个新的段落。

示例:

锄禾日当午,  
汗滴禾下土。

谁知盘中餐,  
粒粒皆辛苦。

效果:

锄禾日当午,
汗滴禾下土。

谁知盘中餐,
粒粒皆辛苦。

3. 分割线

在一行中使用三个以上的星号、减号或底线,且行内除空格以外不能有其它东西,即可实现分割线。

格式:

***
* * *
---
- - -
___
_ _ _

效果:







4. 删除线

在文字两端加上两个波浪线,即可实现删除线。

格式:

~~需要删除的文本内容~~

效果:

需要删除的文本内容

5. 脚注

脚注是对文本的补充说明,可通过[^要注明的文本]实现脚注。

格式:

文本脚注一 [^文本脚注01]。
文本脚注二 [^文本脚注02]。

效果:

文本脚注一 1
文本脚注二 2

列表

1. 无序列表

使用星号、加号或减号作为列表标记,且标记后添加一个空格,再填写内容,可实现一个无序列表。

格式:

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

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

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

效果:

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

2. 有序列表

有序列表,使用数字并加上.号来表示。

格式:

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

效果:

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

3. 嵌套列表

列表嵌套只需要在子列表选项之前添加两个或四个空格即可。

格式:

1. 第一项
    * 第一个元素 
    * 第二个元素 
    * 第三个元素
2. 第二项
    + 第一个周期
    + 第二个周期
    + 第三个周期
3. 第三项
    1. 第一张表格
    2. 第二张表格
    3. 第三张表格

效果:

  1. 第一项
    • 第一个元素
    • 第二个元素
    • 第三个元素
  2. 第二项
    • 第一个周期
    • 第二个周期
    • 第三个周期
  3. 第三项
    1. 第一张表格
    2. 第二张表格
    3. 第三张表格

区块

区块,在段落开头使用>符号且跟一个空格,即可。

格式:

> 区块标题

示例:

> Markdown基本语法  
> Markdown使用教程  
> Markdown示例

效果:

Markdown基本语法
Markdown使用教程
Markdown示例

1. 区块嵌套

区块嵌套,一个>符号表示最外层,两个>符号表示第一层嵌套,以此类推

示例:

> 区块一  
> > 区块二  
> > > 区块三

效果:

区块一

区块二

区块三

2. 区块中使用列表

区块中使用列表,直接在>符号之后添加列表即可。

示例:

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

效果:

区块中使用列表

  1. 第一项
  2. 第二项
  • 第一章
  • 第二章

3. 列表中使用区块

列表中使用区块,需要在>符号之前添加四个空格的缩进。

  • 第一篇

    Markdown基本语法
    Markdown使用教程

  • 第二篇

    实践总结
    结束语

代码

代码,代码片段使用反引号标记,代码块使用四个空格或一个制表符(Tab键)标记。

1. 代码片段

格式:

这是一个 `println()` 方法

效果:

这是一个 println() 方法

2. 代码区块

代码块,使用```包裹起来,并指定一种语言。

格式:

```java
public static void main(String[] args) {
   System.out.println("这是一段代码");
}
```

效果:

public static void main(String[] args) {
   System.out.println("这是一段代码");
}

链接

链接,使用 [链接名称](链接地址)<链接地址> 格式即可。

示例:

[百度一下](https://www.baidu.com/)  
<https://www.baidu.com/>

效果:

百度一下
https://www.baidu.com/

图片

图片,包含图片的名称、地址和标题,其中名称和标题可省略。

格式:

![图片名称](图片地址)  
![图片名称](图片地址 "图片标题")`

示例:

![coffee](/images/post-bg-coffee.jpeg "带标题的图片")

效果:

coffee
带标题的图片

表格

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

表格的标题和内容,对齐方式右三种,分别是:

  1. 左对齐,使用 :- 标记;
  2. 右对齐,使用 -: 标记;
  3. 居中对齐,使用 :-: 标记。

示例:

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

效果:

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

结束语

Markdown是一门很简单的语言,它没有华丽的修饰,主要用于日常写作,掌握起来也很快,看到这里,你已经将Markdown的基本语法全部学完了,接下来就赶紧动起手来进行创作吧!

以下是全文的注脚:


  1. 这是文本脚注一的内容。 ↩︎

  2. 这是文本脚注二的内容。 ↩︎