Markdown 0基础教程：Obsidian 新手入门教程

Markdown 基础教程：Obsidian 新手入门

什么是 Markdown？

Markdown 是一种轻量级文本格式化语言，易于编写和阅读，可转换为 HTML 等格式。在 Obsidian 中，Markdown 结合实时预览和双向链接，适合记录学习笔记、项目文档或个人知识库。

前置条件

• 安装 Obsidian。
• 使用 Obsidian 内置编辑器或任意文本编辑器。
• 建议启用“实时预览”模式，边写边查看格式效果。

Markdown 核心语法（适配 Obsidian）

1. 标题

使用 # 定义标题，数量表示级别（1 到 6 级），后加空格。

语法：

# 一级标题
## 二级标题
### 三级标题

• 一级标题适合笔记主标题，二级及以下用于分节。
• Obsidian 的“大纲”面板会自动显示标题，便于导航。
• 标题后加空行，保持笔记整洁。

2. 段落与换行

段落由连续文本组成，段落间用空行分隔。换行需在行尾加两个空格。

语法：

这是一个段落。  
换行后继续。  

新段落从这里开始。

• 空行确保 Obsidian 正确解析段落。
• 实时预览模式下，段落和换行效果直观。

3. 强调（加粗与斜体）

使用 * 包裹文本实现斜体或加粗。

语法：

*斜体文字*
**加粗文字**
***加粗且斜体***

• 使用 * 更符合 Obsidian 默认主题的显示风格。
• 适度使用强调，突出重点内容。

4. 列表

支持无序列表（符号）和有序列表（数字）。

无序列表

使用 - 创建无序列表。

语法：

- 笔记项目
- 学习任务
  - 子任务 A
  - 子任务 B

• 使用 - 保持风格统一。
• 子列表缩进两到四个空格，支持折叠。

有序列表

使用数字加 . 创建有序列表，Markdown 自动排序。

语法：

1. 第一步
2. 第二步
   1. 子步骤

• 数字无需手动调整，Obsidian 自动规范。

5. 代码块

支持行内代码和多行代码块，适合记录代码或技术笔记。

行内代码

使用单个反引号（`）包裹。

语法：

使用 `print("Hello")` 输出文本。

多行代码块

使用三个反引号（```）并指定语言。

语法：

```python
def greet(name):
    return f"Hello, {name}!"

- 指定语言（如 `python`）启用语法高亮。
- 代码块前后加空行，避免格式干扰。

### 6. 引用
使用 `>` 创建引用，适合记录灵感或摘录。

**语法**：
```markdown
> 重要的笔记内容。  
> 支持多行引用。

• 引用显示为灰色背景，区分正文。
• 可嵌套使用（>>）组织复杂内容。

7. 链接

支持外部链接和 Obsidian 的内部链接。

外部链接

使用 [文本](URL) 格式。

语法：

[Obsidian 官网](https://obsidian.md)

内部链接

链接到知识库中的其他笔记。

语法：

[[我的笔记]]
[[我的笔记#具体标题]]

• 内部链接支持双向链接，自动更新关系图。
• 输入 [[ 时，Obsidian 会提示文件名。

8. 图片

使用 ![描述](URL) 插入图片，支持本地和网络图片。

语法：

![笔记配图](attachment://note-image.jpg)

• 拖入图片到 Obsidian 自动生成 attachment:// 路径。
• 在设置中配置“附件文件夹路径”管理图片。

9. 分隔线

使用三个或以上 - 创建分隔线。

语法：

---

• 使用 --- 作为标准分隔线。
• 分隔线前后加空行，保持整洁。

10. 表格

使用 | 和 - 创建表格，: 控制对齐。

语法：

| 主题     | 描述       | 优先级 |
|---------|-----------|-------|
| 学习     | 完成笔记   | 高     |
| 项目     | 提交代码   | 中     |

• 表格在 Obsidian 预览中自动对齐。
• 保持内容简洁，复杂表格可借助插件。