Markdown教程

梔锿-iyutong-雨桐 Lv2

一.简介

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。这种语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。它编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。文档后缀为 .md, .markdown

二.标题

创建标题的常见语法

1.使用 = 和 -

= 号可表示标记一级, - 号可表示二级标题 (一行中用一个以上来建立,这行内不能有其他东西。)

事例:

1
2
3
4
5
这是一个一级标题
===

这是一个二级标题
---

2.使用 # 号标记

使用 # 号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推

事例:

1
2
##### 5级标题
###### 6级标题

效果:

5级标题
6级标题

三.段落

Markdown 段落没有特殊的格式,直接编写文字就好。

1.换行

输入 两个空格加上回车 表示换行

事例:

1
2
3
4
这是段落一
我没换行
这是段落二
我换行了

效果:

这是段落一
我没换行
这是段落二
我换行了

2.段落

段落后面使用一个空行来表示重新开始一个段落

事例:

1
2
3
这是一个段落

这是一个新段落

效果:

这是一个段落

这是一个新段落

四.字体

使用 * 或者 _ 号包裹可表示斜体文本
使用 ** 或者 __ 号包裹可表示粗体文本
使用 *** 或者 ___ 号包裹可表示粗斜体文本
使用两个 ~ 号包裹可添加删除线
通过 HTML 的 <u> 标签可添加删下划线

事例:

1
2
3
4
5
6
7
8
*斜体文本*  
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
~~这是一个文字~~
<u>这是一个文字</u>

效果:

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本
这是一个文字
这是一个文字

五.分隔线

在一行中用三个以上的 * 或者 _ 或者 - 来建立一个分隔线,这行内不能有其他东西。你也可以在 * 或者 - 中间插入空格。

事例:

1
2
3
4
5
6
7
8
9
***

* * *

*****

- - - -

------

效果:






六.列表

1.无序列表

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格,然后再填写内容

事例:

1
2
3
4
5
6
7
8
9
10
11
* 第一项
* 第二项
* 第三项

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

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

效果:

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

2.有序列表

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

事例:

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

效果:

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

3.列表嵌套

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

事例:

1
2
3
4
5
6
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素

效果:

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

七.区块

区块引用是在段落开头使用 > 符号,然后后面紧跟一个空格符号,区块是可以嵌套的,如果要在列表项目内放进区块,那么就需要在 > 前添加四个空格的缩进

事例:

1
2
3
4
5
6
7
8
9
> 我是区块  
> YT
> 梔锿
>> 我是嵌套区块
>>> 我也是嵌套区块

> * 第一项
> 我是区块
> * 第二项

效果:

我是区块
YT
梔锿

我是嵌套区块

我也是嵌套区块

  • 第一项

    我是区块

  • 第二项

八.代码

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

事例:

1
`printf()` 函数

效果:

printf() 函数

九.代码区块

1.方法一

代码区块使用 4 个空格或者一个制表符(Tab 键)

事例:

1
2
3
$(document).ready(function () {  
alert('RUNOOB');
});

效果:

$(document).ready(function () {
alert(‘RUNOOB’);
});

2.方法二

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

事例:

1
2
3
4
5
```javascript  
$(document).ready(function () {
alert('RUNOOB');
});
```

效果

1
2
3
$(document).ready(function () {
alert('RUNOOB');
});

十.链接

链接使用方法如下:[链接名称](链接地址)或者 <>

事例:

1
2
[梔锿](https://iyutong.cn)  
<https://iyutong.cn>

效果:

梔锿
https://iyutong.cn

十一.图片

1.方法一

使用markdown语法格式如下:![alt 属性文本](图片地址)或者![alt 属性文本](图片地址 "可选标题")

事例:

1
2
![测试](https://www.iyutong.cn/images/iyutongf.webp)  
![测试 图标](https://www.iyutong.cn/images/iyutongf.webp "梔锿")

效果:

测试
测试

测试 图标
测试 图标

2.方法二

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

事例:

1
<img decoding="async" src="https://www.iyutong.cn/images/iyutongf.webp" width="50px"></img>

效果:

十二.表格

表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行
 设置表格的对齐方式:
  -: 设置内容和标题栏居右对齐.
  :- 设置内容和标题栏居左对齐.
  :-: 设置内容和标题栏居中对齐.

事例:

1
2
3
4
5
6
7
8
9
|  表头   | 表头  |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |

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

效果:

表头 表头
单元格 单元格
单元格 单元格
—左对齐123456— —右对齐123456— —居中对齐12345—
单元格 单元格 单元格
单元格 单元格 单元格

十三.HTML 元素

目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>

事例:

1
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

效果:

使用 Ctrl+Alt+Del 重启电脑

  • 标题: Markdown教程
  • 作者: 梔锿-iyutong-雨桐
  • 创建于 : 2024-08-01 16:53:10
  • 更新于 : 2024-09-29 21:15:56
  • 链接: https://www.iyutong.cn/2024/08/01/Markdown教程/
  • 版权声明: 版权所有 © 梔锿-iyutong-雨桐,禁止转载。
评论