Markdown 使用说明

前言

Markdown 是一种轻量级标记语言,创始人为約翰・格魯伯(英语:John Gruber);

它允许人们 “使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者 HTML)文档”;

这种语言吸收了很多在电子邮件中已有的纯文本标记的特性;

—— 维基百科

Markdown 的部分标记有几种不同的符号,但是实现的效果都是相同的,所以文章中每种实现的效果我只写一种符号,一般都是方便且较常用的标记符号;

标题

# H1
## H2
### H3
#### H4

# 的数量代表标题的级别;

换行/段落

我是第一段  
我是第二段

在第一行末尾加上两个空格,以实现换行;

我是第一段

我是第二段

第一行与第二行之间插入空行,以实现切换段落;

斜体 / 加粗

*斜体*
**加粗**
***加粗斜体***

段落两端加上对应数量 *(星号),即可实现以上三种效果;

删除线

~~删除线~~

段落两端加上 ~~ 即可实现 删除线 效果;

下划线(HTML)

下划线

Markdown 语言中没有 下划线 标记,但是可以通过 HTML 的 标记实现下划线效果;

有序列表

1. 列表一
2. 列表二
   1. 子列表一
   2. 子列表二
3. 列表三
  1. 列表一
  2. 列表二

    1. 子列表一
    2. 子列表二
  3. 列表三

无序列表

- 第一种实现符号
- 第二种实现符号
   - 嵌套列表
- 第三种实现符号
  • 第一种实现符号
  • 第二种实现符号

    • 嵌套列表
  • 第三种实现符号

任务列表

- [ ] TODO 1
- [ ] TODO 2
   - [ ] TODO 2.1
   - [x] TODO 2.2
- [x] TODO 3
  • [ ] TODO 1
  • [ ] TODO 2

    • [ ] TODO 2.1
    • [x] TODO 2.2
  • [x] TODO 3

行内代码

全选:`Ctrl + A`

全选:Ctrl + A

代码块

\```
我是代码块(去掉开头转义符号)
\```
我是代码块

高亮代码块

\```javascript
consolo.log('在行首 ``` 后加上代码语言的名字');
consolo.log('即可实现对应的代码高亮效果')
\```
consolo.log('在行首 ``` 后加上代码语言的名字');
consolo.log('即可实现对应的代码高亮效果')

链接/邮箱


mailto:address@email.com
https://in-x.cc/

[Liang's Note](https://in-x.cc/)

Liang's Note

图片

![我的头像](https://www.github.com/liang-n.png/)

Markdown 使用说明_第1张图片

引用块

> 多行引用如果需要换行
> 可在两行之间添加空行
>
> 或在换行前的行末添加两个空格
多行引用如果需要换行
可在两行之间添加空行
或在换行前的行末添加两个空格

嵌套引用

> 时间就是生命,我的朋友
>> Yes!

时间就是生命,我的朋友

Yes!

表格

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

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

单元格对齐:

  • :- :左对齐
  • :-: :居中
  • -: :右对齐
| 表头   | 表头  |   表头 |
| :----- | :---: | -----: |
| 左对齐 | 居中  | 右对齐 |
表头 表头 表头
左对齐 居中 右对齐

分隔符

---

转义字符

Markdown 的占用了很多常用符号,如:*-~

如果我们写文档时需要显示这些符号,可以使用转义字符 \标记符号 转义为 普通符号 显示出来;

*斜体文本*
\*斜体文本\*

斜体文本
*斜体文本*

**加粗文本**
\*\*加粗文本\*\*

加粗文本
**加粗文本**

你可能感兴趣的:(markdown程序员)