概念百科
Markdown 是什么
Markdown 的概念、与 Word 的区别,以及完整基础语法速查。
本文侧重 Markdown 本身的概念与语法。在 Obsidian 里写作时的扩展语法见 Obsidian 基础语法 与 Obsidian 扩展 Markdown。
一句话理解
Markdown 是一种用纯文本写文档的轻量标记语言,文件扩展名通常是 .md。
用 #、*、- 等符号标记标题、强调、列表,人类可直接阅读源码,程序也能稳定解析——GitHub、Obsidian、多数文档站都广泛使用。
和 Word 有什么不同?
| Word(.docx) | Markdown(.md) | |
|---|---|---|
| 本质 | 二进制包,格式复杂 | 纯文本,任意编辑器都能打开 |
| 排版 | 所见即所得,按钮点选 | 符号标记,预览时渲染 |
| 版本管理 | 不适合 Git diff | 非常适合 diff、合并 |
| 典型用途 | 正式公文、复杂排版 | 笔记、README、知识库 |
很多用户把 Word 资料 转成 Markdown 再放进 Obsidian,就是为了统一格式、方便搜索和 双链。
基础语法速查
以下语法在 Obsidian、GitHub、多数编辑器中通用。Obsidian 另支持 ==高亮==、[[双链]] 等,见 Obsidian 板块。
段落与换行
第一段与第二段之间空一行。
同一段内强制换行:行末两个空格再回车,
或 Obsidian 中 Shift+Enter。标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题文本样式
| 样式 | 写法 |
|---|---|
| 加粗 | **文字** 或 __文字__ |
| 斜体 | *文字* 或 _文字_ |
| 删除线 | ~~文字~~ |
| 加粗+斜体 | ***文字*** |
| 行内代码 | `代码` |
Obsidian 还支持 ==高亮==。
链接与图片
[链接文字](https://example.com)

Obsidian 仓库内笔记常用 [[笔记名]] 或 [文字](笔记.md),见 内链说明。
引用
> 引用内容
> 可多行列表
无序:
- 项目 A
- 项目 B
- 子项目有序:
1. 第一步
2. 第二步任务(Obsidian / GitHub 等支持):
- [x] 已完成
- [ ] 待办分隔线
---
***
___代码块
```js
console.log("Hello");
```opening fence 后加语言名可语法高亮,如 js、python、bash。
表格
| 列1 | 列2 |
| --- | --- |
| A | B |
| 左对齐 | 右对齐 |
| :--- | ---: |详见 进阶排版 — 表格。
脚注
正文[^1]。
[^1]: 脚注说明。转义
显示字面符号时在前面加 \:\* \# ` 等。
和图床、Obsidian 的关系
想系统学 Obsidian 写法?
| 文档 | 内容 |
|---|---|
| Obsidian 入门 | 仓库、双链、插件等概念 |
| 基础 Markdown 语法 | 完整基础语法 |
| 进阶排版语法 | 表格、Mermaid、数学公式 |
最后更新时间: 2026-06-18 02:53:47