03-Markdown语法速成与笔记写作-尧图网络科技

03 · Markdown语法速成与笔记写作

——不会写代码也能掌握的通用写作语言

王姐是一名有10年经验的图书编辑，一直用Word排版稿件。朋友推荐她尝试Markdown写作时，她第一反应是："我是文科生，不是程序员。"试用一周后，她感叹：“用了这么多年Word，我才发现大部分排版操作都是在浪费时间——Markdown让我专注于内容本身。”

一、你最需要的基础语法

Markdown的设计哲学：用最少的符号，表达最常见的文档结构。你只需花15分钟掌握以下语法，就能写出结构清晰、排版美观的任何文档。

标题

一行#符号加空格，就能创建标题。一个#是最高级标题（等价于HTML的H1），六个#是最低级标题（H6）。Obsidian的文件名自动作为一级标题，所以笔记内部通常从二级标题开始使用。

# 这是一级标题（对应文件名） ## 这是二级标题 ### 这是三级标题 #### 这是四级标题

列表

无序列表用-或*开头，有序列表用1. 2. 3.。支持嵌套——在子项前缩进两个空格即可。

- 苹果 - 香蕉 - 海南香蕉 - 进口香蕉 1. 第一步：打开Obsidian 2. 第二步：新建笔记

引用和代码块

行内引用用>符号，多行引用在每行前面加>。代码块用三个反引号包裹，可以指定语言以启用语法高亮：

> 知识就是力量。——弗朗西斯·培根 \```python print("Hello, Obsidian!") \```

表格

Markdown表格用|分隔列，第二行用---分隔表头和内容，:控制对齐方式（:---左对齐、---:右对齐、:---:居中）。

| 工具 | 数据归属 | 价格 | |:---|:---:|---:| | Obsidian | 本地 | 免费 | | Notion | 云端 | 付费 | | OneNote | 云端+本地缓存 | 免费 |

链接与图片

普通链接用[显示文字](URL)格式。图片在链接前加一个感叹号：![图片描述](图片路径或URL)。在Obsidian中，你也可以将图片直接拖入编辑区，它会自动生成引用语法并复制图片到Vault的附件文件夹中。

[访问Obsidian官网](https://obsidian.md) ![Obsidian界面截图](附件/obsidian-ui.png)

二、Obsidian特有的扩展语法

标准Markdown已经足够强大，但Obsidian在此基础上增加了几项"杀手级"扩展，让笔记写作体验大幅提升。

高亮（Highlight）

用==双等号==包裹文字即可实现荧光笔效果。这在阅读笔记和复习场景中非常实用——你可以在资料摘录中标记最重要的段落。

Obsidian采用**本地优先**的设计理念，==这意味着你的数据永远属于你==。

脚注（Footnote）

脚注是学术写作和深度阅读笔记的利器。在正文中用[^编号]标记注释位置，在文末用[^编号]: 注释内容定义具体注释。阅读模式下，脚注会展示为优雅的上标链接。

双向链接是Obsidian最核心的功能[^1]。 [^1]: 双向链接最早源于20世纪60年代的Hypertext概念，Obsidian将其真正落地到商业产品中。

数学公式

需要写理工科笔记的用户会爱上Obsidian对LaTeX数学公式的原生支持。行内公式用 $公式$ ，独立公式用$$公式$$。无需安装任何插件即可渲染。

爱因斯坦的质能方程：$E=mc^2$ 泰勒展开公式： $$ e^x = \sum_{n=0}^{\infty} \frac{x^n}{n!} $$

三、编辑模式与实时预览的高效配合

Obsidian提供了两种视图模式，理解它们的区别和最佳切换时机，能显著提升你的写作效率。

编辑模式：显示完整的Markdown源码。你在写链接[[笔记名]]、代码块、或需要精确控制格式时，编辑模式是最佳选择。快捷键Ctrl+E切换到编辑模式（Mac用户使用Cmd+E）。

阅读模式：将Markdown源码渲染为美观的格式化页面。反向链接、脚注、数学公式都会以最舒适的方式呈现。当你要回顾笔记、展示给别人看、或者进行阅读批注时，请使用阅读模式。

实时预览（Live Preview）：Obsidian 1.0版本之后引入的最重要的改进。在实时预览模式下，你输入的Markdown语法会即时渲染为格式化效果——输入**粗体**的瞬间文字就变粗，输入[[后自动弹出笔记搜索面板。对新手而言，建议默认开启实时预览模式，因为所见即所得的体验降低了学习Markdown的心理门槛。

王姐的工作流：在笔记本电脑上分屏操作——左半屏是参考资料的PDF，右半屏是Obsidian编辑区。她用Ctrl+P打开命令面板，输入"Toggle reading view"在编辑和阅读间切换。写初稿时使用实时预览模式，定稿后切换到阅读模式反复通读修改。

一个实用的写作习惯：先用纯文字记录核心内容，写完再补充格式。不要边写边纠结加粗还是列表——内容质量远比排版华丽重要。Obsidian的优势恰恰在于，它让你"先写后排版"，而不是像Word那样"边写边排版"。

结语：Markdown不是程序员专属的技能，它是数字时代的基本写作素养。当你不再被排版工具打断思路，你会发现——写作本身就是最好的思考方式。

💡关键行动点
▸ 打开Obsidian创建一个新笔记，练习标题、列表、引用三种基础语法
▸ 尝试用==高亮==和[^脚注]写一篇读书笔记，感受扩展语法的便利
▸ 在编辑模式和阅读模式之间切换，找到最适合你的写作节奏

📚延伸阅读