Markdown 基础语法

摘要:知识库里的每篇笔记本质上都是纯文本文件,用 Markdown 语法写格式。不需要全记住,常用的这十几个够日常写作用了。

标题

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

项目档案、案例摘要基本只用到二级(##)和三级(###),一级标题一般只在页面最开头用一次(很多模板里甚至用 HTML 卡片代替了一级标题)。

加粗、斜体

**这是加粗**
*这是斜体*

列表

- 无序列表项一
- 无序列表项二
  - 缩进的子项
 
1. 有序列表项一
2. 有序列表项二

链接

[显示文字](https://example.com)     ← 外部链接
[[页面名称]]                        ← 知识库内部双链,见 [[Obsidian使用指引/双链与反向链接]]

表格

| 姓名 | 单位 | 职位 |
|------|------|------|
| 张三 | ASK  | 顾问 |

案例摘要里的”整合评估”表格、专家资源库的表格都是这个写法。

引用块

> 这是一段引用文字

每篇知识笔记开头的”摘要”段落用的就是这个格式:> **摘要**:……

代码块

用三个反引号包裹,可以指定语言高亮:

```python
print("hello")
```

Dataview 查询语句也是用代码块写的,只不过语言标记是 dataview(详见 Dataview查询入门)。

待办事项

- [ ] 未完成的任务
- [x] 已完成的任务

项目档案的”知识沉淀进度”清单用的就是这个格式,勾选后会显示删除线效果。

HTML 混排

Markdown 允许直接插入 HTML 标签,本知识库大量使用这个特性来实现自定义卡片样式(比如项目档案顶部的彩色标题区、案例摘要的 kn-header):

<div class="kn-header" style="--kn-color:#1a5276;">
...
</div>

这些自定义样式只在预览模式下生效,写新笔记时直接复制模板里现成的 HTML 结构改内容即可,不需要自己从零写。

与本知识库的关联