Markdown 从入门到精通-详细教程
Markdown 标题
1 | # 一级标题 |
预览效果
使用 # 符号来表示标题的级别,标题级别从 1 到 6,可以通过增加 # 的数量来调整标题的层级。
Markdown 段落
1 | 这是第一个段落。这段话描述了第一个段落的内容。 |
预览效果
只要在文本中添加一个空行,Markdown 就会自动将其识别为一个新的段落。
Markdown 换行
1 | 这是第一行文本。 |
预览效果
换行的语法是通过在 行尾添加两个空格,然后按回车键来实现的。通过在行尾添加两个空格,可以在同一段落中实现换行,否则,Markdown 默认会将连续的文本合并到同一段落中。
Markdown 强调
1 | *这是斜体文本* |
预览效果
在 Markdown 中,以上语法会根据使用的星号或下划线数量,将文本显示为斜体、加粗或斜体加粗。
Markdown 引用
1 | > 这是一个引用段落。 |
- 预览效果
在 Markdown 中,使用 > 符号可以轻松地创建引用块,适合用来引用他人的话语、展示引用内容 ,或者强调某些段落。
Markdown 列表
1.无序列表
无序列表使用星号 *或加号 + 或减号 - 来标记每一项。
1 | * 第一项 |
预览效果
2.有序列表
有序列表使用数字加点号. 来标记每一项。数字不必按照顺序排列,Markdown 会自动渲染为正确的顺序。
1 | 1. 第一项 |
预览效果
Markdown 表格
1.简单表格
1 | | 姓名 | 年龄 | 职业 | |
预览效果
| 姓名 | 年龄 | 职业 |
|---|---|---|
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |
| 王五 | 28 | 教师 |
2.对齐方式
左对齐:在列的左边添加冒号 :--- 或 :-
右对齐:在列的右边添加冒号 ---: 或 -:
居中对齐:在列的两边添加冒号 :---: 或 :-:
1 | | 姓名 | 年龄 | 职业 | |
预览效果
| 姓名 | 年龄 | 职业 |
|---|---|---|
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |
| 王五 | 28 | 教师 |
在 Markdown 中,表格的语法非常简单明了。表格由管道符号 | 分隔列,用短横线 - 分隔表头和表体。你还可以通过冒号 : 来控制列的对齐方式。
Markdown 脚注
1.单个脚注
1 | 这是一个带有脚注的句子[^1]。 |
预览效果
这是一个带有脚注的句子^1。
在需要添加脚注的地方使用方括号加上脚注标识符,如 [^1],在文档的任意位置定义脚注内容,使用相同的脚注标识符加上冒号 : 和内容。
- 脚注标识符:使用
[^1]在文本中插入脚注标记。 - 脚注定义:在文档末尾或任何地方使用
[^1]:来定义脚注内容。
2.多个脚注
1 | 这是第一个脚注示例[^1],这是第二个脚注示例[^2]。 |
Markdown 代码块
1.基本代码块
1 | ``` |
预览效果
1 | 这是一个代码块示例。 |
基本代码块:无论你使用什么内容,只要前后用三个反引号包围起来,Markdown 渲染器都会把它显示为代码块,且不会应用其他文本格式。
2.语法高亮代码块
1 | ```python |
预览效果
1 | def greet(name): |
带有语法高亮的代码块:通过指定语言,为代码应用语法高亮,可以在开头的三个反引号后指定代码的语言,以启用语法高亮。常见的语言包括 python、javascript、html、css 等。这有助于提高代码的可读性。
3.代码块嵌套
1 | ```` |
预览效果
1 | 这是外层代码块的开始 |
使用四个反引号 ```````` 来创建外层代码块,然后在其中使用三个反引号 ``` 来创建内层代码块。这样,内层的三个反引号就会被完整无损地显示出来。
这种方法可以确保内层的代码块分隔符 ``` 被完整地显示出来,而不会影响整体的Markdown结构。如果您需要在更深层次嵌套代码块,可以继续增加外层代码块的反引号数量。
例如,使用五个反引号 ````````` 作为最外层,四个反引号 ```````` 作为中间层,。以此类推。
Markdown 分隔线
1 | *** |
预览效果
使用三个星号 *,或使用三个减号 -,或使用三个下划线 _。任意一种方法都将生成一个水平分隔线。使用不同种方法之间必须至少有一个空行。
Markdown 删除线
1 | - 旧的价格是 ~~$50~~,现在的价格是 $30。 |
预览效果
- 旧的价格是
$50,现在的价格是 $30。 这个选项已经被取消。
通过使用双波浪线`~~`来创建删除线。删除线用于表示已被删除或不再适用的文本。
使用 ~~ 包围要删除的文本,即可生成删除线效果。
Markdown 反引号
在 Markdown 中,如果要将单词或短语表示为代码,可以将其包裹在反引号 () 中。对于包含反引号的代码片段,可以使用双反引号 (``) 来包裹。 1.单个反引号 ()
1 | 这是 `代码` 示例。 |
预览效果
这是 代码 示例。
2.双反引号 (``)
1 | 这是 `` `代码` 示例 `` 的使用方法。 |
预览效果
这是 `代码` 示例 的使用方法。
Markdown 插入链接
1 | [链接文本!点击此处](https://example.com) |
预览效果
链接文本!点击此处
Markdown 插入图片
1 |  |
预览效果
Markdown 转义字符
1 | \* 这是星号符号,不是斜体或加粗 \* |
预览效果
* 这是星号符号,不是斜体或加粗 *
_ 这是下划线符号,不是斜体 _
# 这是一个普通的井号,不是标题 #
[ 这是一个普通的方括号,不是链接 ]
> 这是一个普通的大于号,不是引用 >
以下是一些常用的 Markdown 转义字符:
\*转义星号,通常用于斜体或加粗\_转义下划线,通常用于斜体或加粗\#转义井号,通常用于标题\[转义方括号,通常用于链接\(转义圆括号,通常用于链接\>转义大于号,通常用于引用\反斜杠本身也可以转义
在 Markdown 中,转义字符用于显示通常具有特殊意义的字符,例如 *, _, #, [ 等。这些字符通常用于格式化文本。但如果你希望它们以普通文本的形式出现,可以使用反斜杠 \ 来转义它们。
Markdown 任务列表
1 | 待办事项: |
预览效果
待办事项:
- 写报告
- 会议纪要
- 提交项目
语法:使用 - [ ] 表示未完成的任务,- [x] 表示已完成的任务。
Markdown 使用表情
1 | 今天的任务列表: |
预览效果
今天的任务列表:
- 完成报告 ✅
- 开会 ⏳
- 锻炼 💪
项目状态更新:🚀 - 第一阶段 ✔️
- 第二阶段 ⏳
- 最终阶段 🚧
1 | 常见的 Emoji 代码 |
点击此处更多Emoji-Markdown参考
使用 :emoji_code: 来插入表情符号。表情符号会在支持的 Markdown 渲染器中显示为相应的图标。
Markdown 自动链接
- 在 Markdown 中,如果你直接输入一个网址,它通常会自动转换为可点击的链接,而不需要任何额外的语法。这种方式被称为“自动链接”。
1.自动链接1
2
3我的个人博客:https://www.example.com
联系我:email@example.com
预览效果
我的个人博客:https://www.example.com
2.禁用自动链接
如果不希望自动链接,可将链接放在在反引号 ` ` 中,显示为普通文本而不会被自动转换为链接。
1 | 我的个人博客:`https://www.example.com` |
预览效果
我的个人博客:https://www.example.com
联系我:email@example.com