Markdown教程
一.简介
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. 第三项效果:
- 第一项
- 第二项
- 第三项
3.列表嵌套
列表嵌套只需在子列表中的选项前面添加两个或四个空格即可
事例:
1
2
3
4
5
6 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>效果:
十一.图片
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-雨桐,禁止转载。