阿乔的笔记

Obsidian 高级技巧详解

9 min read

MOC (Map of Content) 作为主题导航

什么是 MOC？

MOC（内容地图）是一种组织和导航笔记的方法，它充当特定主题或领域的中央索引页面。这个概念由 Nick Milo 在他的 LYT（Linking Your Thinking）方法中推广。

MOC 的核心功能

  1. 导航中心：作为特定主题的所有相关笔记的入口点
  2. 概念组织：以有意义的方式组织相关概念，而不仅仅是按文件夹
  3. 关系可视化：展示笔记之间的关系和连接
  4. 思维框架：提供对主题的高层次理解和框架

MOC 示例

以下是一个”人工智能”主题的 MOC 示例：

# 人工智能 MOC
 
## 核心概念
- [[机器学习基础]]
- [[神经网络架构]]
- [[深度学习原理]]
- [[强化学习]]
 
## 应用领域
- [[计算机视觉]]
- [[自然语言处理]]
- [[推荐系统]]
- [[自动驾驶]]
 
## 伦理与社会影响
- [[AI伦理问题]]
- [[算法偏见]]
- [[自动化与就业]]
 
## 关键人物
- [[图灵|艾伦·图灵]]
- [[明斯基|马文·明斯基]]
- [[辛顿|杰弗里·辛顿]]
 
## 相关项目
- [[个人AI助手项目]]
- [[图像识别实验]]
 
## 学习资源
- [[AI课程笔记]]
- [[推荐书籍与论文]]

创建有效 MOC 的步骤

  1. 确定主题范围：明确定义 MOC 将覆盖的主题边界
  2. 收集相关笔记：识别所有与该主题相关的笔记
  3. 分类组织：创建有意义的分类和子分类
  4. 添加上下文：为每个链接添加简短描述或上下文
  5. 维护更新：随着新笔记的创建，持续更新 MOC

MOC 的优势

  • 提供比标签或文件夹更灵活的组织方式
  • 允许一个笔记出现在多个 MOC 中
  • 创建知识的多层次视图
  • 帮助发现笔记之间的新关联
  • 避免”迷失在笔记海洋中”的问题

YAML 前置元数据增强笔记属性

什么是 YAML 前置元数据？

YAML 前置元数据（Front Matter）是放在 Markdown 文件顶部的一段 YAML 格式的元数据，用三个连字符（---）包围。它允许您为笔记添加结构化的元数据，这些元数据可以被 Obsidian 及其插件识别和利用。

基本语法

---
title: "笔记标题"
date: 2025-03-15
tags: [obsidian, 知识管理, 笔记系统]
status: 进行中
priority: 高
---
 
笔记正文内容开始...

常用元数据字段

  1. 基本信息

    • title: 笔记标题
    • date: 创建日期
    • modified: 修改日期
    • author: 作者

  2. 分类组织

    • tags: 标签数组
    • category: 分类
    • type: 笔记类型（如：永久笔记、文献笔记等）

  3. 状态追踪

    • status: 笔记状态（草稿、进行中、已完成等）
    • progress: 完成度百分比
    • priority: 优先级

  4. 关联信息

    • related: 相关笔记列表
    • sources: 参考来源
    • projects: 相关项目

  5. 自定义字段

    • rating: 个人评分
    • review-frequency: 复习频率
    • difficulty: 难度级别

YAML 前置元数据的应用

  1. 增强搜索功能

    • 使用 Obsidian 的搜索操作符（如 tag:）精确查找笔记
    • 结合 Dataview 插件进行高级查询

  2. 动态生成内容

    • 使用 Dataview 创建基于元数据的动态列表和表格
    • 例如：显示所有”高优先级”且”进行中”的笔记

  3. 自动化工作流

    • 结合 Templater 插件自动填充元数据
    • 使用 Tasks 插件基于元数据管理任务

  4. 数据可视化

    • 创建基于元数据的仪表板
    • 生成进度报告和统计信息

示例：使用 Dataview 查询基于元数据的笔记

| File                                 | 创建日期           | 状态 | 优先级 |
| ------------------------------------ | -------------- | -- | --- |
| [[项目规划/🎧 MoeMusic.md\|🎧 MoeMusic]] | March 18, 2025 | 归档 | 低   |
 
 
| File                                 | 创建日期           | 状态 | 优先级 |
| ------------------------------------ | -------------- | -- | --- |
| [[项目规划/🎧 MoeMusic.md\|🎧 MoeMusic]] | March 18, 2025 | 归档 | 低   |
 
### 最佳实践
 
1. **保持一致性**：为所有笔记使用一致的元数据结构
2. **建立模板**：创建包含常用元数据字段的笔记模板
3. **适度使用**：只添加有实际用途的元数据，避免过度复杂化
4. **记录元数据模式**：创建一个专门的笔记记录您使用的元数据字段及其含义
5. **利用插件**：结合 Dataview、Templater、MetaEdit 等插件充分利用元数据
 
通过结合使用 MOC 和 YAML 前置元数据，您可以创建一个既有结构化组织又有灵活性的知识管理系统，让您的 Obsidian 知识库更加强大和实用。
 
 
 
根据你提供的 Quartz 4 官方文档页面，那种带图标和蓝色底的 "Flags and options" 部分是使用 **Markdown 的 callout 语法** 实现的。
 
## Quartz 4 中的 Callout 语法
 
在 Quartz 4 中，你可以使用以下语法创建带样式的提示框：
 
````markdown
> [!info] Flags and options
> 
> For full help options, you can run `npx quartz build --help`.
> 
> Most of these have sensible defaults but you can override them if you have a custom setup:
> - `-d` or `--directory`: the content folder. This is normally just `content`
> - `-v` or `--verbose`: print out extra logging information
> - `-o` or `--output`: the output folder. This is normally just `public`

Flags and options

For full help options, you can run npx quartz build --help.

Most of these have sensible defaults but you can override them if you have a custom setup:

  • -d or --directory: the content folder. This is normally just content
  • -v or --verbose: print out extra logging information
  • -o or --output: the output folder. This is normally just public

可用的 Callout 类型

Quartz 4 支持多种 callout 类型，每种都有不同的颜色和图标：

  • [!info] - 蓝色，信息图标
  • [!warning] - 黄色，警告图标
  • [!error] - 红色，错误图标
  • [!success] - 绿色，成功图标
  • [!note] - 灰色，笔记图标
  • [!tip] - 绿色，提示图标

语法要点

  1. 开头：使用 > 引用符号
  2. 标识符：[!类型] 后面跟标题
  3. 内容：每行都需要 > 开头
  4. 支持 Markdown：内部可以使用代码块、列表等格式

这样就能创建出像官方文档中那样美观的带图标和彩色背景的提示框了。

根据 Quartz 4 官方文档，那种单独被框起来的 .gitlab-ci.yml 是使用 文件名标注语法 实现的。

语法格式

在 Markdown 中，你可以这样写：

In your local Quartz, create a new file `.gitlab-ci.yml`.
 
`.gitlab-ci.yml`
```yaml
# 这里是文件内容
```

In your local Quartz, create a new file .gitlab-ci.yml.

.gitlab-ci.yml

# 这里是文件内容

实际效果

这会产生两个效果：

  1. 行内代码：句子中的 .gitlab-ci.yml 会被灰色背景框起来
  2. 文件标题：单独一行的 .gitlab-ci.yml 作为代码块的标题显示

更完整的示例

Create a new file `.gitlab-ci.yml` in your project root.
 
`.gitlab-ci.yml`
```yaml
image: node:18-alpine
 
pages:
  stage: deploy
  script:
    - npm ci
    - npx quartz build
  artifacts:
    paths:
      - public
  only:
    - main
```

关键点

  • 行内代码：用单个反引号 ` 包围文件名
  • 文件标题：单独成行，通常放在代码块前面
  • 代码块：用三个反引号 ``` 包围，并指定语言类型

这样就能创建出像官方文档中那样的文件名标注效果了。

Graph View

Backlinks