1.为什么要选择Markdown笔记？#

选择 Markdown，主要是因为它在“易写、易读、易迁移”之间取得了很好的平衡：

• 简单：用少量符号就能写标题、列表、链接、代码和表格。

• 专注内容：不像复杂排版软件那样需要频繁调整格式。

• 纯文本保存：文件小、稳定，不容易因为软件升级而损坏。

• 跨平台：Windows、macOS、Linux、手机都能打开。

• 方便迁移：可以在 Obsidian、Typora、VS Code、GitHub 等工具中使用。

• 适合长期积累：笔记不会被某个软件锁定，未来更换工具也能继续使用。

• 适合版本管理：文本文件容易比较修改记录，也方便备份和同步。

简单说，Markdown 把“写内容”和“排版”分开了。你只需要专注于思考，格式保持清晰即可。

2.如何开始#

可以在网上寻找适合你的markdown编辑器 这里编者使用obsidian(ob一串字母） 然后是创建自己的仓库和开始使用源码编辑来写一篇属于你自己的笔记

标题#

1
# 一级标题
2
## 二级标题
3
### 三级标题
4
#### 四级标题

段落与换行#

1
这是一个段落。
2

3
这是另一个段落。

行末添加两个空格可以换行：

1
第一行
2
第二行

文字强调#

1
**粗体**
2
*斜体*
3
***粗斜体***
4
~~删除线~~
5
==高亮==

效果：粗体、斜体、粗斜体、删除线、==高亮==。

列表#

1
- 苹果
2
- 香蕉
3
  - 国产香蕉
4
  - 进口香蕉

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

1
- [ ] 未完成任务
2
- [x] 已完成任务

链接#

1
[OpenAI](https://openai.com)

1
https://blog.maszr.space

1
[[另一篇笔记]]
2
[[另一篇笔记|自定义显示文字]]
3
[[另一篇笔记#某个标题]]

1
[[笔记名称#二级标题]]

1
[[笔记名称^段落编号]]

图片嵌入#

1
![图片描述](https://example.com/image.png)

1
![图片描述](附件/示例图片.png)

1
![[示例图片.png]]

1
![[示例图片.png|500]]
2
![[示例图片.png|300x200]]

1
<img src="附件/示例图片.png" width="500">

1
![[图片文件名.png]]

引用#

1
> 这是一段引用。
2
>
3
> 引用可以有多个段落。

嵌套引用：

1
> 第一层引用
2
>> 第二层引用

代码#

1
使用 `Ctrl + P` 打开命令面板。

1
```javascript
2
console.log("Hello Markdown");
3
```

1
```python
2
```javascript
3
```typescript
4
```css
5
```html
6
```bash
7
```json

分割线#

1
---

或：

1
***

表格#

1
| 姓名 | 年龄 | 城市 |
2
| --- | ---: | :--- |
3
| 小明 | 18 | 北京 |
4
| 小红 | 20 | 上海 |

说明：

• ---：默认对齐；
• ---:：右对齐；
• :---：左对齐；
• :---:：居中对齐。

转义字符#

如果想显示 Markdown 符号本身，可以使用反斜杠：

1
\*这不是斜体\*
2
\# 这不是标题
3
\[这不是链接\]

脚注#

1
Markdown 很适合写知识笔记。[^1]
2

3
[^1]: 这是脚注内容。

HTML#

Markdown 中可以使用部分 HTML：

1
<details>
2
<summary>点击查看详细内容</summary>
3

4
这里是隐藏的详细内容。
5

6
</details>

这里是隐藏的详细内容。

Obsidian 标签#

1
#学习
2
#编程/Markdown
3
#状态/待整理

标签通常用于分类、筛选和标记状态。

Obsidian 注释#

1
%% 这段内容只在编辑模式中可见 %%

也可以注释多行：

1
%%
2
这是一段不会在阅读模式中显示的内容。
3
%%

Obsidian 提示框#

1
> [!note] 注意
2
> 这是一条普通提示。
3

4
> [!tip] 技巧
5
> 这里可以放一个实用技巧。
6

7
> [!warning] 警告
8
> 这里可以放风险提示。
9

10
> [!quote] 引用
11
> 这里可以放重要引用。

常见类型包括：

1
note
2
tip
3
warning
4
danger
5
example
6
quote
7
info
8
success
9
question

YAML 属性#

笔记开头可以添加属性：

1
---
2
title: Markdown 语法总结
3
created: 2026-07-27
4
tags:
5
  - Markdown
6
  - Obsidian
7
status: evergreen
8
---

常用组合模板#

1
---
2
title: 主题名称
3
created: 2026-07-27
4
tags:
5
  - 分类
6
---
7

8
# 主题名称
9

10
> 一句话总结这篇笔记。
11

12
## 核心内容
13

14
- 要点一
15
- 要点二
16

17
## 示例
18

19
```javascript
20
console.log("example");

图片#

![[示例图片.png]]

相关笔记#

• [[相关主题]]

下一步#

• 完成实践
• 补充案例

1
最常用、最值得优先掌握的是：标题、列表、任务列表、链接、图片、代码块、引用、表格、标签和双向链接。

1.打开管理员面板#

使用/admin进入管理员面板

使用编者账密登录

2.开始Markdown文章编写#

点击“文章”卡片

设置标题 封面 分类 摘要等

在正文页面中开始编辑文章内容

保存为正式文章或草稿

3.完成发布#

点击“发布与回滚”卡片

根据指引完成新版本发布