风凌天下的博客
前往主站点（国内）

markdown基础语法

 分类：经验分享  字数：2198  阅读时长：5 分钟  浏览量：

Markdown是一种非常流行的轻量级标记语言。它的核心目标是让人们能够使用易于阅读、易于编写的纯文本格式来写作，然后可以轻松地转换为结构化的、格式丰富的HTML或其他格式。

简单来说，它用一些简单的符号（比如 #、*、- 等）来代替复杂的HTML标签，让你专注于内容本身，而不是排版。

Markdown的核心优势

  1. 易读易写：即使没有经过渲染，原始的Markdown文档也具有很强的可读性。
  2. 通用性强：绝大多数代码托管平台（如GitHub、GitLab）、笔记软件（如Notion、Obsidian、Typora）、博客平台（如WordPress）都支持Markdown。
  3. 专注于内容：你不用费心去调整字体、颜色、大小，只需关心文章的结构和逻辑。

基础Markdown语法详解

下面是一些最常用、最核心的Markdown语法。

1. 标题

使用 # 号来表示标题，从1级到6级。# 的数量对应标题的级别。

# 这是一级标题 (相当于 HTML 的 <h1>)
## 这是二级标题 (<h2>)
### 这是三级标题 (<h3>)
#### 这是四级标题 (<h4>)
##### 这是五级标题 (<h5>)
###### 这是六级标题 (<h6>)

渲染效果：

这是一级标题

这是二级标题

这是三级标题

2. 强调（粗体和斜体）

  • 粗体：用两个 * 或 _ 包裹文字。
  • 斜体：用一个 * 或 _ 包裹文字。
这是 *斜体文本*
这也是 _斜体文本_

这是 **粗体文本**
这也是 __粗体文本__

这是 ***粗体加斜体***

渲染效果：
这是 斜体文本
这是 粗体文本
这是 粗体加斜体

3. 列表

无序列表：使用 -、+ 或 * 作为列表标记。

- 项目一
- 项目二
  - 子项目一（缩进两个空格或一个Tab）
- 项目三

渲染效果：

  • 项目一
  • 项目二
    • 子项目一
  • 项目三

有序列表：使用数字加 .。

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

渲染效果：

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

4. 链接

[链接文本](链接地址 "可选的标题")

访问 [百度](https://www.baidu.com) 搜索。
访问 [GitHub](https://github.com "前往GitHub主页") 获取更多信息。

渲染效果：
访问 百度 搜索。

也可以使用参考链接，大量饮用某链接的时候很有用，而且文档会很美观，不会带着链接，可前面用方括号声明链接文字，方便直接饮用，然后可以在文档末尾补齐链接，声明的链接可包含链接标题。

[点此访问github][github]
[github]: https://github.com/]

5. 图片

语法与链接类似，前面多一个 !。
![图片替代文本](图片URL "可选的标题")

![公安备案图标](/icons/gonganbeian.png "辽公网安备21130202000476号")

渲染效果：

公安备案图标※ 辽公网安备21130202000476号

这里也可以写带图片的链接，语法就是把图片作为链接的标题,链接显示的文本直接在图片文本里写就行，然后后面正常饮用链接。

[![风凌天下的博客](/icons/favicon.svg)](https://fltxdbk.yydjtc.cn "随心所欲的个人博客")

渲染效果：

风凌天下的博客

这里也可以像链接那样实现参考链接。

[![风凌天下的博客][icons]][blog-link]
[icons]: /icons/favicon.svg
[blog-link]: https://fltxdbk.yydjtc.cn "一个随心所欲的个人博客"

6. 代码

  • 行内代码：用一个反撇号 ` 包裹代码。

    使用 `printf()` 函数来打印内容。

    渲染效果：
    使用 printf() 函数来打印内容。

  • 代码块：用三个反撇号 ``` 包裹代码，并可以在第一个反撇号后指定语言以实现语法高亮。

    ```python
def hello_world():
    print("Hello, World!")
```

    渲染效果：

    def hello_world():
    print("Hello, World!")

7. 分割线

使用三个或以上的 -、* 或 _ 来创建一条分割线。

---
***
___

渲染效果：

8. 表格

基础表格语法
  1. 基本结构

表格由三部分组成：表头、分隔线、表格行。

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

渲染效果：

表头1 表头2 表头3
单元格1 单元格2 单元格3
单元格4 单元格5 单元格6
  1. 对齐方式

通过分隔线中的冒号 : 来控制对齐：

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容左 |  内容中  | 内容右 |
| 数据1  |  数据2   |  数据3 |

渲染效果：

左对齐 居中对齐 右对齐
内容左 内容中 内容右
数据1 数据2 数据3
  • :--- 左对齐
  • :--: 居中对齐
  • ---: 右对齐
  • --- 默认左对齐（大部分解析器）
高级技巧和注意事项
  1. 单元格内换行

有些Markdown解析器支持HTML标签：

| 功能 | 描述 |
|:-----|:-----|
| 多行文本 | 第一行<br>第二行 |
| 特殊格式 | **粗体**、*斜体*、`代码` |
  1. 表格内使用链接和图片
| 网站 | 链接 | 图标 |
|:-----|:-----|:-----|
| 百度 | [百度搜索](https://baidu.com) | ![图标](favicon.ico) |
| GitHub | [GitHub](https://github.com) | 🐙 |

9. 转义字符

要显示原本用于格式化 Markdown 文档的字符，请在字符前面添加\。

注意，如果要写真正的反斜杠，就要血两个反斜杠已代表一个反斜杠，因为一个反斜杠会被markdown认为是转义字符，所以第一个反斜杠是启用转义，第二个反斜杠才会被渲染，同理，写两个反斜杠就要写四个反斜杠，以此类推。

如何开始使用Markdown？

  1. 编辑器：你可以使用任何纯文本编辑器（如记事本、VS Code、Sublime Text）。但推荐使用专门的Markdown编辑器，它们可以实时预览渲染效果，例如 Typora、Obsidian、VS Code（安装Markdown预览插件）。
  2. 保存文件：将文件保存为 .md 或 .markdown 后缀。
  3. 练习：最好的学习方式就是动手实践。创建一个 .md 文件，把上面的语法都尝试一遍！

总结

Markdown的语法非常直观，以上这些基础语法已经能满足你90%的日常写作需求。它的哲学是 “让标记尽可能不明显地干扰你的写作”。一旦熟悉，你就会发现用它来写文档、记笔记、写博客是多么高效和愉悦。

相关文章：

标签：
下一篇：

评论