Markdown 完全入门指南

我是椰汁，今天，我想向你介绍一种可以让你专注于内容本身，而不是排版细节的标记语言——Markdown

什么是 Markdown？

Markdown 是一种轻量级标记语言，由约翰·格鲁伯（John Gruber）在2004年创建。它的核心理念是 “易读易写”。

简单来说，你只需要用一些简单的符号（如 #、*、-）来标注文本的格式，Markdown 就会自动将其转换为结构化的 HTML 或美观的排版。这意味着你可以在写作的同时完成排版，让手指不必频繁地在键盘和鼠标之间切换。

为什么要学习 Markdown？

1.专注于内容：告别“写一行调半天格式”的烦恼，让思维更连贯。

2.纯文本，跨平台：任何设备上的任何文本编辑器都能打开 Markdown 文件，永不担心格式错乱。

3.版本控制友好：在 Git 等版本控制系统中，Markdown 可以清晰地记录每一次改动。

4.应用广泛：从 Github 的 README、技术文档，到博客写作、笔记软件（如 Obsidian、Notion），Markdown 无处不在。

1.标题

使用 # 符号来表示标题，几个 # 就代表几级标题，使用时记得在 # 后加一个空格。

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题

效果预览：

这是一级标题

这是二级标题

这是三级标题

这是四级标题

2.强调

通过符号让文字变得有“语气”。

*这是斜体* 或 _这也是斜体_
**这是粗体** 或 __这也是粗体__
***这是粗斜体*** 或 ___这也是粗斜体___
~~这是删除线~~

效果预览：

这是斜体 或 这也是斜体

这是粗体 或 这也是粗体

这是粗斜体 或 这也是粗斜体

这是删除线

3.列表

让内容更有条理，支持无序和有序两种列表。

无序列表：使用 -、* 或 + 开头。

- 苹果
- 香蕉
- 橙子

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

1.打开冰箱门
2.把大象放进冰箱 
3.关上冰箱门 

嵌套列表：缩进即可。

- 编程语言
  - Python
  - JavaScript
- 数据库
  - MySQL
  - MongoDB

效果预览：

• 苹果
• 香蕉
• 橙子

1.打开冰箱门

2.把大象放进冰箱

3.关上冰箱门

• 编程语言
  • Python
  • JavaScript
• 数据库
  • MySQL
  • MongoDB

4.链接与图片

超链接和插入图片的语法非常相似，只是图片多了一个 !。

链接：

[点击访问我的博客](https://example.com)

图片：

![图片加载失败的替代文字](图片的URL地址)

效果预览：

点击访问我的博客

5.引用

当你需要引用他人的话或资料时，使用 >。

> 这是引用的内容。
> 可以跨多行。
> 
> 甚至可以分段（中间空一行）。

效果预览：

这是引用的内容。
可以跨多行。

甚至可以分段（中间空一行）。

6.代码

展示代码是程序员的刚需，Markdown 支持行内代码和代码块。

行内代码：使用反引号 ` 包裹。

在终端输入 `npm install` 命令。

代码块：使用三个反引号 ``` 包裹，并可以指定语言以获得语法高亮。

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

效果预览：

在终端输入 npm install 命令。

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

7.表格

虽然语法稍显复杂，但 Markdown 的表格足够直观。

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

小提示：第二行的 :--- 表示左对齐，:--: 表示居中对齐，---: 表示右对齐。

效果预览：

8.分割线

用三个或以上的 - 或 * 来创建一条水平分割线。

---
***

效果预览：

进阶技巧

当你熟练掌握基础语法后，可以尝试一些更高级的功能，让你的文档更专业。

任务列表

在笔记或项目管理中非常实用。

- [x] 已完成的任务
- [ ] 待办任务1
- [ ] 待办任务2

效果预览：

• 已完成的任务
• 待办任务1
• 待办任务2

脚注

为文档中的术语或引用添加补充说明。

这是一句需要解释的话[^1]。

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

目录生成

许多 Markdown 编辑器（如 Typora）或平台（如 Github）支持根据标题自动生成目录，通常用 [TOC] 或 [[TOC]]。

[TOC]

如何开始使用 Markdown？

1.选择一个好用的编辑器：

• Typora：极简风格，所见即所得，强烈推荐初学者使用。
• Visual Studio Code：安装插件后功能强大，适合程序员。
• Obsidian：构建知识库的神器，双链笔记的佼佼者。
• 在线工具：如 StackEdit、Cmd Markdown，无需安装即可使用。
  2.新建文件：创建一个扩展名为 .md 的文件，开始你的第一篇 Markdown 写作吧！

Markdown 不仅仅是一种语法，更是一种写作理念。它让我们从复杂的排版工具中解放出来，重新找回写作本身的乐趣。

希望今天的教程对你有所帮助。如果你有任何关于 Markdown 的问题或心得，欢迎在评论区留言交流！

Happy Markdowning!