MarkDown教程

2025 年 12 月 20 日

1261 字

4 分钟

其他

使用方法

标题 (Headings)

使用 # 号来创建标题,一个 # 代表一级标题,两个 ## 代表二级标题,以此类推,最多支持六级。

语法:

Markdown

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

段落和换行 (Paragraphs & Line Breaks)

段落之间需要一个空行。如果只是按一次回车,在很多 Markdown 渲染器中会被视为同一个段落内的换行,可能不会显示为新的一行。

语法:

Markdown

这是第一段。

这是第二段。
这是第二段的另一行,但没有空行,所以它们在同一段落。

如果想强制换行,可以在行尾添加两个或更多的空格,然后回车。

强调 (Emphasis)

  • 加粗:使用两个星号 ** 或两个下划线 __ 包裹。
  • 斜体:使用一个星号 * 或一个下划线 _ 包裹。
  • 加粗并斜体:使用三个星号 *** 或三个下划线 ___ 包裹。

语法:

Markdown

*这是斜体*
_这也是斜体_

**这是加粗**
__这也是加粗__

***这是加粗并斜体***
___这也是加粗并斜体___

列表 (Lists)

无序列表

使用 *、+ 或 - 来创建。

语法:

Markdown

- 任务一
- 任务二
  - 子任务 A
  - 子任务 B
* 项目一
+ 项目二

效果:

  • 任务一
  • 任务二
    • 子任务 A
    • 子任务 B

有序列表

使用数字加一个点 . 来创建。

语法:

Markdown

1. 第一步
2. 第二步
3. 第三步
   1. 详细步骤 1
   2. 详细步骤 2

效果:

  1. 第一步
  2. 第二步
  3. 第三步
    1. 详细步骤 1
    2. 详细步骤 2

语法: [链接显示的文字](链接地址 "可选的悬停标题")

Markdown

[Google 官网](https://www.google.com "访问谷歌")

效果: Google 官网

图片 (Images)

语法与链接非常相似,只是在前面多一个感叹号 !。

语法: ![图片无法显示时的替代文字](/notes-images/图片链接或本地路径)

Markdown

![Google Logo](https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png)

效果:

引用 (Blockquotes)

使用 > 符号。可以嵌套使用。

语法:

Markdown

> 这是第一层引用。
>
> > 这是第二层引用。
>
> 回到第一层。

效果:

这是第一层引用。

这是第二层引用。

回到第一层。

代码 (Code)

行内代码

使用一对反引号 “ 包裹。

语法:

Markdown

在 JavaScript 中,使用 `console.log()` 来打印日志。

效果: 在 JavaScript 中,使用 console.log() 来打印日志。

代码块

使用三个反引号 ``` 包裹。你还可以在开头指定语言来实现语法高亮。

语法:

Markdown

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

hello_world()
```

效果:

Python

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

hello_world()

分割线 (Horizontal Rules)

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

语法:

Markdown

---
***
___

效果:


扩展:

第三部分:扩展语法(让你的笔记更强大)

这些语法属于扩展功能(通常被称为 GFM - GitHub Flavored Markdown),大部分现代编辑器都支持。

1. 表格 (Tables)

语法:

Markdown

| 表头1 | 表头2 | 居中对齐 | 右对齐 |
| :---- | :---- | :------: | -----: |
| 单元格1 | 单元格2 | 单元格3 | 单元格4 |
| 单元格A | 单元格B | 单元格C | 单元格D |
  • : 的位置决定了对齐方式。

效果: | 表头1 | 表头2 | 居中对齐 | 右对齐 | | :---- | :---- | :------: | -----: | | 单元格1 | 单元格2 | 单元格3 | 单元格4 | | 单元格A | 单元格B | 单元格C | 单元格D |

2. 任务列表 (Task Lists)

语法:

Markdown

- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 计划中的任务

效果:

  • 已完成的任务
  • 未完成的任务
  • 计划中的任务

3. 删除线 (Strikethrough)

使用两个波浪号 ~~ 包裹。

语法:

Markdown

~~这是一段被删除的文字。~~

效果: 这是一段被删除的文字。

4. 脚注 (Footnotes)

语法:

Markdown

这是一个需要添加脚注的句子。[^1]

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

效果: 这是一个需要添加脚注的句子。^1

第四部分:笔记组织最佳实践

工具和语法是基础,如何组织才是核心。

  1. 建立清晰的文件夹结构:
    • 按项目:为每个项目建立一个文件夹。
    • 按领域:如 01_工作, 02_学习, 03_生活。
    • P.A.R.A 方法:一种流行的组织方法,分为 Projects (项目), Areas (领域), Resources (资源), Archives (存档)。
  2. 统一文件名规范:
    • 一个好的文件名可以让你快速找到笔记。
    • 推荐格式:YYYY-MM-DD-笔记关键词.md,例如 2025-09-17-Markdown教程.md。
  3. 使用模板:
    • 对于重复性的笔记,如会议纪要、读书笔记、每日计划,可以创建模板文件。每次写新笔记时,复制模板即可。
    • 会议纪要模板示例:
  4. 利用标签 (Tags):
    • 很多 Markdown 编辑器(如 Obsidian, Joplin)支持 #标签。
    • 你可以为笔记打上多个标签,方便横向关联和筛选,例如 #工作/项目A,#学习/编程。
  5. 建立索引和链接:
    • 创建一个 索引.md 或 MOC (Map of Content) 文件,作为某个主题的入口,链接到所有相关的笔记。
    • 在笔记之间使用 [[双向链接]](Obsidian 等工具支持)来关联相关概念,构建知识网络。
MarkDown教程
https://blog.yagami.top/blog/markdown教程/
作者
Nekode
发布时间
2025 年 12 月 20 日
许可协议
CC BY-NC-SA 4.0

正在加载评论...

输入关键词开始搜索