MarkDown(.md)教程

冯马佑 📋在职小初生

什么是 Markdown?

  • 一种轻量级标记语言
  • 通过纯文本编写结构化内容
  • 易读易写,可转换为 HTML/PDF 等格式
  • 广泛用于文档、博客、GitHub 等平台

基本语法

1. 标题

1
2
3
4
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
实例&效果

示例:

1
2
3
# 欢迎使用 Markdown
## 这是一个二级标题
### 这是一个三级标题

效果:

欢迎使用 Markdown

这是一个二级标题

这是一个三级标题


2. 段落与换行

  • 段落:直接换行文字
  • 强制换行:行尾添加两个空格
    或在段落间空一行
实例&效果

示例:

1
2
3
4
这是第一段文字。

这是第二段文字。
这是同一段内的换行。

效果:
这是第一段文字。

这是第二段文字。
这是同一段内的换行。


3. 列表

无序列表

1
2
3
- 项目1
- 项目2
- 子项目

有序列表

1
2
1. 第一项
2. 第二项
实例&效果

示例:

1
2
3
4
5
6
- 苹果
- 香蕉
- 黄香蕉
- 绿香蕉
1. 第一步
2. 第二步

效果:

  • 苹果
  • 香蕉
    • 黄香蕉
    • 绿香蕉
  1. 第一步
  2. 第二步

4. 强调

1
2
3
*斜体*_斜体_
**粗体**__粗体__
***粗斜体***___粗斜体___
实例&效果

示例:

1
这是 *斜体*,这是 **粗体**,这是 ***粗斜体***

效果:
这是 斜体,这是 粗体,这是 粗斜体


5. 链接与图片

1
2
[链接文字](https://example.com)
![图片描述](image.jpg)
实例&效果

示例:

1
2
访问 [Google](https://www.google.com)。
![Markdown Logo](https://markdown-here.com/img/icon256.png)

效果:
访问 Google
Markdown Logo


6. 代码

行内代码

1
使用 `print("Hello")` 语法

代码块

1
print("Hello World")
实例&效果

示例:

1
2
3
4
5
6
这是行内代码:`print("Hello")`

这是代码块:
```python
def hello():
print("Hello World")
1
2
3
4
5
6
7
8

**效果:**
这是行内代码:`print("Hello")`。

这是代码块:
```python
def hello():
print("Hello World")

7. 表格

1
2
3
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 内容1 | 内容2 | 内容3 |
实例&效果

示例:

1
2
3
4
| 姓名   | 年龄 | 职业     |
| :----- | :--: | --------: |
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |

效果:

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

8. 分割线

1
2
3
---

***
实例&效果

示例:

1
2
3
这是第一部分。
---
这是第二部分。

效果:
这是第一部分。

这是第二部分。


9. 引用

1
2
> 引用内容
>> 嵌套引用
实例&效果

示例:

1
2
> 这是一个引用。
>> 这是一个嵌套引用。

效果:

这是一个引用。

这是一个嵌套引用。


高级语法

1. 任务列表

1
2
- [ ] 未完成
- [x] 已完成
实例&效果

示例:

1
2
- [x] 学习 Markdown 基础
- [ ] 完成 Markdown 作业

效果:

  • 学习 Markdown 基础
  • 完成 Markdown 作业

2. 数学公式(需支持 LaTeX)

1
2
3
$$
E = mc^2
$$
实例&效果

示例:

1
2
3
4
这是质能方程:  
$$
E = mc^2
$$

效果:
这是质能方程:
$$
E = mc^2
$$


3. 流程图(需特定解析器)

graph TD
A[开始] --> B{判断}
B -->|是| C[执行]
B -->|否| D[结束]

实例&效果

效果:

graph TDA[开始] --> B{判断}B -->|是| C[执行]B -->|否| D[结束]

总结

优势

  • 专注内容而非格式
  • 版本控制友好
  • 跨平台兼容

📝 适用场景

  • 技术文档
  • 笔记整理
  • 博客写作

提示:不同平台的 Markdown 解析器可能有细微差异,建议测试实际效果

  • 标题: MarkDown(.md)教程
  • 作者: 冯马佑
  • 创建于 : 2025-03-09 10:48:00
  • 更新于 : 2025-03-09 12:29:08
  • 链接: https://blog.fengmayou.top/2025/03/09/makedown-firset/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
评论