Markdown 基础语法

简介 Introduction

Markdown 是一种轻量级标记语言,创始人为 John Gruber。它允许开发者使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML 或 HTML 文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

下面是 Markdown 的基本语法。


语法 Syntax

标题 Heading

标题是每篇文章必须的格式,在 Markdown 中,想要添加标题只需要在文字前加#即可。#的个数决定了标题的级数,一共六级。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

段落与换行 Paragraph

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行。Markdown 的段落没有特殊的格式,可以直接编写文字。段落的换行是使用两个以上的空格加上回车


区块引用 Quote

Markdown 标记区块引用是使用类似 Email 中>的引用方式。只需在每行的前面加上>

> 这是一段引用

效果:

这是一段引用

此外,区块引用可以嵌套,只要根据层级加上不同数量的>

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

效果:

最外层

第一层嵌套

第二层嵌套


列表 List

类似于 HTML,Markdown 支持有序列表和无序列表。列表允许嵌套。

无序列表使用*+- 作为列表标记:

* HTML
* CSS
* JavaScript

等同于:

+ HTML
+ CSS
+ JavaScript

也等同于:

- HTML
- CSS
- JavaScript

效果:

  • HTML
  • CSS
  • JavaScript

有序列表使用数字后接一个英文句点:

1. Red
2. Blue
3. Green

效果:

  1. Red
  2. Blue
  3. Green

值得注意的是,有序列表中列表标记的数字并不会决定输出结果的顺序。例如:

3. Red
1. Blue
6. Green

效果:

  1. Red

  2. Blue

  3. Green


分隔线 Separation Line

可以在一行中使用三个以上的*-_ 来建立一个分隔线,行内不能有其他东西。例如:

***
*******
-----------
___________

字体 Font

  • 删除线

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

~~这段文字加了删除线~~

效果:

这段文字加了删除线

  • 斜体

如果要对某段文字增加倾斜效果,在文字的左右分别用一个*,例如:

*这段文字是斜体*

效果:

这段文字是斜体

  • 加粗

如果要对某段文字加粗,在文字的左右分别用两个* ,例如:

**这段文字是粗体**

效果:

这段文字是粗体

  • 斜体加粗

斜体和粗体的组合效果,在文字的左右分别用三个*,例如:

***这段文字是斜体加粗体***

效果:

这段文字是斜体加粗体


代码 Code

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

`System.out.print()`

效果:

System.out.print()

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

```javascript
console.log('Hello World');
​```

效果:

console.log('Hello World');

超链接 Anchor

Markdown 超链接的语法:

[链接名称](链接地址) 或者 <链接地址>

例如:

[bing](https://www.bing.com) 或者 <https://www.bing.com>

效果: bing 或者 https://www.bing.com


图片 Image

Markdown 使用一种和链接很相似的语法来标记图片:

![图片的替代文字](图片路径)
  • 开头一个感叹号!
  • 接着一个方括号,里面是图片的替代文字
  • 接着是一个普通括号,里面是图片的路径或者地址,最后还可以用引号包住并加上选择性的 'title' 属性的文字。

表格 Table

Markdown 使用- 来分隔表头和其它行,用| 来分隔不用的单元格,语法:

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

表格的对齐方式:
-: 右对齐
:- 左对齐(默认)
:-: 居中
左对齐 居中 右对齐
单元格 单元格 单元格
单元格 单元格 单元格
单元格 单元格 单元格
posted @ 2022-09-14 11:08  Mitchell_C  阅读(166)  评论(0编辑  收藏  举报