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 结构改内容即可,不需要自己从零写。
与本知识库的关联
- 各类页面的标准 HTML 结构模板见 _索引
- YAML 属性区(frontmatter)的写法见 Markdown与YAML规范