Markdown 与 Obsidian 语法学习指南

1.1 基本语法#

1
---
2
title: 笔记标题
3
created: 2026-06-05
4
tags:
5
  - 标签1
6
  - 标签2
7
---

1.2 常用字段速查#

注意： Frontmatter 必须在文件的最开头，--- 之前不能有任何字符（包括空行）。

2.1 语法#

1
# 一级标题（笔记大标题，一般只用一次）
2
## 二、大章节
3
### 2.1 小节
4
#### 2.1.1 子小节

2.2 渲染效果对照#

2.3 排版技巧#

Python 笔记的标题编排规律：

• ## 用于”第几章”：## 二、Python的基础语法
• ### 用于”第几节”：### 2.1 字面量
• #### 用于”第几小节”：#### 2.1.1 什么是字面量

这种编号 + 标题名的格式，能让目录自动生成清晰的层级结构。

3.1 粗体与斜体#

1
**粗体文字**      → 用于强调关键概念
2
*斜体文字*        → 用于术语或轻微强调
3
***粗斜体***      → 极度强调

渲染效果：

3.2 Python 笔记中的强调规律#

原笔记中大量使用 **粗体**，规律如下：

• 关键词加粗：**Python** **通过缩进判断代码块的归属关系。**
• 注意事项加粗：**要注意，无论键盘输入什么类型的数据，获取到的数据永远都是字符串类型**
• 语法格式加粗：**def 函数名(传入参数)：**

4.1 基本语法#

1
> 这是一个引用块

渲染效果：

这是一个引用块

4.2 多行引用#

1
> 第一行内容
2
>
3
> 第二行内容（空行+>可以产生段落间距）
4
>
5
> 第三行内容

第一行内容

第二行内容（空行+>可以产生段落间距）

第三行内容

4.3 嵌套引用#

1
> 外层引用
2
>
3
> > 内层引用（多一个>符号）

外层引用

内层引用（多一个>符号）

4.4 引用块的使用场景（来自 Python 笔记的总结）#

5.1 行内代码#

用一对反引号包裹：

1
使用 `print()` 函数输出内容

渲染效果：使用 print() 函数输出内容

5.2 代码块（带语言高亮）#

用三个反引号包裹，并指定语言名称：

1
```python
2
name = "Hello"
3
print(name)
4
```

渲染效果：

1
name = "Hello"
2
print(name)

5.3 常用语言标识#

5.4 Python 笔记中的代码块使用模式#

原笔记的代码块呈现三步式结构：

1. 文字说明：解释要做什么
2. 代码块：展示实际代码
3. 运行结果：用图片或引用块展示输出

1
演示代码：
2
```python
3
print("Hello")

运行结果：

Hello

6.1 无序列表#

1
- 项目一
2
- 项目二
3
  - 子项目（缩进2个空格）
4
  - 子项目
5
- 项目三

渲染效果：

• 项目一
• 项目二
  • 子项目（缩进2个空格）
  • 子项目
• 项目三

6.2 有序列表#

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

渲染效果：

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

6.3 Python 笔记中列表的典型用法#

用于列举要点：

1
> •简单易学
2
> •全球第一
3
> •优雅
4
> •应用场景丰富

•简单易学 •全球第一 •优雅 •应用场景丰富

用于注意事项：

1
> • **条件需提供布尔类型结果，True继续，False停止**
2
> • **空格缩进不能忘**
3
> • **请规划好循环终止条件，否则将无限循环**

• 条件需提供布尔类型结果，True继续，False停止 • 空格缩进不能忘 • 请规划好循环终止条件，否则将无限循环

7.1 语法#

1
---

渲染效果：

7.2 使用建议#

Python 笔记中的分割线使用规律：

• 在每个 ## 大章节结束后加一条 ---
• 用来分隔不同主题的内容块
• 不要过度使用，否则页面会显得碎片化

8.1 基本语法#

1
![替代文字](图片地址)

8.2 外部图片（网络链接）#

1
![](https://example.com/image.png)

8.3 Obsidian 本地图片（推荐）#

1
![[image.png]]

Obsidian 特有语法： 使用 ![[]] 双括号嵌入本地图片，优势：

• 图片存在本地，不依赖网络
• 支持拖拽插入
• 可以在 Obsidian 中直接预览
• 修改图片文件名时自动更新引用

8.4 图片存放建议#

1
你的Vault/
2
├── attachments/       ← 建议的图片存放目录
3
│   ├── python_01.png
4
│   └── python_02.png
5
├── notes/
6
│   └── 学习笔记.md    ← 引用: ![[attachments/python_01.png]]

9.1 基本语法#

1
| 列标题1 | 列标题2 | 列标题3 |
2
|---------|---------|---------|
3
| 内容1   | 内容2   | 内容3   |
4
| 内容4   | 内容5   | 内容6   |

9.2 对齐方式#

1
| 左对齐 | 居中对齐 | 右对齐 |
2
|:-------|:--------:|-------:|
3
| 左     |   中     |     右 |

9.3 适用场景#

用表格来呈现对比性信息效果最佳：

• 数据类型对比（string vs int vs float）
• 函数/方法速查表
• 运算符一览
• 不同容器的特点对比

10.1 内部链接（Wiki-links）#

1
[[笔记名称]]               ← 链接到其他笔记
2
[[笔记名称|显示文字]]       ← 自定义显示文字
3
[[文件夹/笔记名称]]        ← 链接到指定文件夹下的笔记

10.2 标签（Tags）#

1
在笔记任意位置写 #标签名 即可
2

3
例如：#python #学习笔记 #编程入门

标签 vs 目录：

• 标签是跨文件夹的，同一标签可以出现在不同目录的笔记中
• 建议建立标签体系，如：#语言/python、#类型/教程

10.3 ⭐Callout 高亮框（Obsidian 增强语法）#

1
> [!note] 笔记标题
2
> 这是一个普通的笔记框
3

4
> [!tip] 提示
5
> 这是一个提示框
6

7
> [!warning] 警告
8
> 这是一个警告框
9

10
> [!danger] 危险
11
> 这是一个危险提示框

2.2 注意事项#

• 要点一：解释说明

• 要点二：解释说明

• 要点三：解释说明