Markdown 从入门到精通

Markdown 标题

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

预览效果
m001

使用 # 符号来表示标题的级别,标题级别从 1 到 6,可以通过增加 # 的数量来调整标题的层级。

Markdown 段落

这是第一个段落。这段话描述了第一个段落的内容。

这是第二个段落。你可以在段落之间插入一个空行来分隔不同的段落。

预览效果
m002

只要在文本中添加一个空行,Markdown 就会自动将其识别为一个新的段落。

Markdown 换行

这是第一行文本。  
这是第二行文本,位于第一行的下面。

这是第三行文本。注意它与上面的行之间有一个空行,属于新段落。

预览效果
m003

换行的语法是通过在 行尾添加两个空格,然后按回车键来实现的。通过在行尾添加两个空格,可以在同一段落中实现换行,否则,Markdown 默认会将连续的文本合并到同一段落中。

Markdown 强调

*这是斜体文本*

_这也是斜体文本_

**这是加粗文本**

__这也是加粗文本__

***这是斜体加粗文本***

___这也是斜体加粗文本___

预览效果
m004

在 Markdown 中,以上语法会根据使用的星号或下划线数量,将文本显示为斜体、加粗或斜体加粗。

Markdown 引用

> 这是一个引用段落。

>> 这是一个嵌套的引用段落。

> ### 引用中的标题
> 你可以在引用中使用标题、**加粗文本**、_斜体文本_,甚至列表。
> - 引用中的无序列表项 1
> - 引用中的无序列表项 2
  • 预览效果
    m005

在 Markdown 中,使用 > 符号可以轻松地创建引用块,适合用来引用他人的话语、展示引用内容 ,或者强调某些段落。

Markdown 列表

1.无序列表
无序列表使用星号 *或加号 + 或减号 - 来标记每一项。

* 第一项
* 第二项
  * 第二项的子项 1
  * 第二项的子项 2
- 第三项
+ 第四项

预览效果
m006

2.有序列表
有序列表使用数字点号. 来标记每一项。数字不必按照顺序排列,Markdown 会自动渲染为正确的顺序。

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

预览效果
m007

Markdown 表格

1.简单表格

| 姓名   | 年龄 | 职业   |
| ------ | ---- | ----- |
| 张三   | 25   | 工程师 |
| 李四   | 30   | 设计师 |
| 王五   | 28   | 教师   |

预览效果

姓名年龄职业
张三25工程师
李四30设计师
王五28教师

2.对齐方式
左对齐:在列的左边添加冒号 :---:-
右对齐:在列的右边添加冒号 ---:-:
居中对齐:在列的两边添加冒号 :---::-:

| 姓名   | 年龄 | 职业   |
| :----  | ---: | :----: |
| 张三   | 25   | 工程师 |
| 李四   | 30   | 设计师 |
| 王五   | 28   | 教师   |

预览效果

姓名年龄职业
张三25工程师
李四30设计师
王五28教师

在 Markdown 中,表格的语法非常简单明了。表格由管道符号 | 分隔列,用短横线 - 分隔表头和表体。你还可以通过冒号 : 来控制列的对齐方式。

Markdown 脚注

1.单个脚注

这是一个带有脚注的句子[^1]。

[^1]: 这是脚注的内容。

预览效果
这是一个带有脚注的句子1

在需要添加脚注的地方使用方括号加上脚注标识符,如 [^1],在文档的任意位置定义脚注内容,使用相同的脚注标识符加上冒号 : 和内容。

  • 脚注标识符:使用 [^1] 在文本中插入脚注标记。
  • 脚注定义:在文档末尾或任何地方使用 [^1]: 来定义脚注内容。

2.多个脚注

这是第一个脚注示例[^1],这是第二个脚注示例[^2]。

[^1]: 第一个脚注的内容。
[^2]: 第二个脚注的内容。

预览效果
这是第一个脚注示例2,这是第二个脚注示例3

Markdown 代码块

1.基本代码块

```
这是一个代码块示例。
可以包含多行代码。
```

预览效果

这是一个代码块示例。
可以包含多行代码。

基本代码块:无论你使用什么内容,只要前后用三个反引号包围起来,Markdown 渲染器都会把它显示为代码块,且不会应用其他文本格式。

2.语法高亮代码块

```python
def greet(name):
    return f"Hello, {name}!"
```

预览效果

def greet(name):
    return f"Hello, {name}!"

带有语法高亮的代码块:通过指定语言,为代码应用语法高亮,可以在开头的三个反引号后指定代码的语言,以启用语法高亮。常见的语言包括 python、javascript、html、css 等。这有助于提高代码的可读性。

3.代码块嵌套

````
这是外层代码块的开始
```
这是内层代码块
它可以包含 ``` 而不会破坏格式
```
这是外层代码块的结束
````

预览效果

这是外层代码块的开始
```
这是内层代码块
它可以包含 ``` 而不会破坏格式
```
这是外层代码块的结束

使用四个反引号 ```````` 来创建外层代码块,然后在其中使用三个反引号 ``` 来创建内层代码块。这样,内层的三个反引号就会被完整无损地显示出来。
这种方法可以确保内层的代码块分隔符 ` 被完整地显示出来,而不会影响整体的Markdown结构。如果您需要在更深层次嵌套代码块,可以继续增加外层代码块的反引号数量。
例如,使用五个反引号 ````````` 作为最外层,四个反引号 ```````` 作为中间层,。以此类推。

Markdown 分隔线

***

---

预览效果



使用三个星号 *,或使用三个减号 -,或使用三个下划线 _。任意一种方法都将生成一个水平分隔线。使用不同种方法之间必须至少有一个空行

Markdown 删除线

- 旧的价格是 ~~$50~~,现在的价格是 $30。
- ~~这个选项已经被取消。~~

预览效果

  • 旧的价格是 ~~$50~~,现在的价格是 $30。
  • 这个选项已经被取消。

通过使用双波浪线`~~`来创建删除线。删除线用于表示已被删除或不再适用的文本。
使用 ~~ 包围要删除的文本,即可生成删除线效果。

Markdown 反引号

在 Markdown 中,如果要将单词或短语表示为代码,可以将其包裹在反引号 () 中。对于包含反引号的代码片段,可以使用双反引号 (`) 来包裹。
1.单个反引号 (`)

这是 `代码` 示例。

预览效果
这是 代码 示例。

2.双反引号 (``)

这是 `` `代码` 示例 `` 的使用方法。

预览效果
这是 `代码` 示例 的使用方法。

Markdown 插入链接

[链接文本!点击此处](https://example.com)

预览效果
链接文本!点击此处

Markdown 插入图片

![替代文本](https://example.com/image.jpg)

预览效果
image

Markdown 转义字符

\* 这是星号符号,不是斜体或加粗 \*
\_ 这是下划线符号,不是斜体 \_
\# 这是一个普通的井号,不是标题 \#
\[ 这是一个普通的方括号,不是链接 \]
\> 这是一个普通的大于号,不是引用 \>

预览效果
* 这是星号符号,不是斜体或加粗 *
\_ 这是下划线符号,不是斜体 \_
\# 这是一个普通的井号,不是标题 \#
[ 这是一个普通的方括号,不是链接 ]
\> 这是一个普通的大于号,不是引用 \>

以下是一些常用的 Markdown 转义字符:

  • \* 转义星号,通常用于斜体或加粗
  • \_ 转义下划线,通常用于斜体或加粗
  • \# 转义井号,通常用于标题
  • \[ 转义方括号,通常用于链接
  • \( 转义圆括号,通常用于链接
  • \> 转义大于号,通常用于引用
  • \ 反斜杠本身也可以转义

在 Markdown 中,转义字符用于显示通常具有特殊意义的字符,例如 *, _, #, [ 等。这些字符通常用于格式化文本。但如果你希望它们以普通文本的形式出现,可以使用反斜杠 \ 来转义它们。

Markdown 任务列表

待办事项:
- [ ] 写报告
- [x] 会议纪要
- [ ] 提交项目

预览效果
待办事项:

  • 写报告
  • 会议纪要
  • 提交项目

语法:使用 - [ ] 表示未完成的任务,- [x] 表示已完成的任务。

Markdown 使用表情

今天的任务列表:
- 完成报告 :white_check_mark:
- 开会 :hourglass_flowing_sand:
- 锻炼 :muscle:

项目状态更新::rocket:
- 第一阶段 :heavy_check_mark:
- 第二阶段 :hourglass:
- 最终阶段 :construction:

预览效果
今天的任务列表:

  • 完成报告 ✅
  • 开会 ⏳
  • 锻炼 💪
    项目状态更新:🚀
  • 第一阶段 ✔️
  • 第二阶段 ⏳
  • 最终阶段 🚧
常见的 Emoji 代码
- `:smile:` 😄
- `:heart:` ❤️
- `:thumbsup:` 👍
- `:fire:` 🔥
- `:star:` ⭐
- `:tada:` 🎉

点击此处更多Emoji-Markdown参考
使用 :emoji_code: 来插入表情符号。表情符号会在支持的 Markdown 渲染器中显示为相应的图标。

Markdown 自动链接

  • 在 Markdown 中,如果你直接输入一个网址,它通常会自动转换为可点击的链接,而不需要任何额外的语法。这种方式被称为“自动链接”。
    1.自动链接

    我的个人博客:https://www.example.com
    
    联系我:email@example.com

预览效果
我的个人博客:https://www.example.com

联系我:email@example.com

2.禁用自动链接
如果不希望自动链接,可将链接放在在反引号 ` ` 中,显示为普通文本而不会被自动转换为链接。

我的个人博客:`https://www.example.com`

联系我:`email@example.com`

预览效果
我的个人博客:https://www.example.com

联系我:email@example.com

文章作者: 无念log
文章链接: https://silys.nianlink.top/index.php/archives/5/
版权声明: 本网站所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 伤极无念log-科技、爱好、工具!
分类: 修仙文档 标签: Markdown 文档修仙文档

评论

-- 评论已关闭 --

目录