Obsidian Essentials Free

SKILL.md

---
name: "obsidian-essentials-free"
description: "Obsidian新手入门与核心配置免费版，含安装、领先篇笔记、Markdown基础、核心配置与基础工作流。"
license: Proprietary
allowed-tools: read exec
compatibility: "Requires LLM with tool-use capability"
metadata:
  displayName: "Obsidian基础入门(免费版)"
  version: "1.0.0"
  summary: "Obsidian新手入门与核心配置免费版，含安装、领先篇笔记、Markdown基础、核心配置与基础工作流。"
  tags:
    - "Obsidian"
    - "新手入门"
    - "核心配置"
    - "Markdown"
  source: "SkillHub"
  converted_at: "2026-07-22T17:58:36"
---

> **不是教你成为Obsidian高手，而是带你从零开始迈出领先步。安装、配置、领先篇笔记，新手友好。**

Obsidian的灵活性与强大功能对新手既是机遇也是挑战。如何下载安装？如何创建领先个vault？如何写领先篇笔记？如何配置核心选项？本技能聚焦新手入门全流程，帮助Agent引导用户顺利完成Obsidian的初次配置与基础使用。

## 架构总览
```text
┌─────────────────────────────────────────────────────────┐
│              Obsidian基础入门 (免费版)                    │
├─────────────────────────────────────────────────────────┤
│                                                          │
│  ┌────────────────────────────────────────────┐          │
│  │            安装配置层                        │          │
│  │   下载 → 安装 → 创建vault → 界面熟悉        │          │
│  └────────────────────────────────────────────┘          │
│                          │                               │
│                          ▼                               │
│  ┌────────────────────────────────────────────┐          │
│  │            领先篇笔记层                      │          │
│  │   新建笔记 → Markdown基础 → 保存预览        │          │
│  └────────────────────────────────────────────┘          │
│                          │                               │
│                          ▼                               │
│  ┌────────────────────────────────────────────┐          │
│  │            核心配置层                        │          │
│  │   编辑器 │ 外观 │ 文件与链接                 │          │
│  └────────────────────────────────────────────┘          │
│                          │                               │
│                          ▼                               │
│  ┌────────────────────────────────────────────┐          │
│  │            基础工作流层                      │          │
│  │   日记笔记 │ 会议笔记 │ 项目笔记             │          │
│  └────────────────────────────────────────────┘          │
│                          │                               │
│                          ▼                               │
│  ┌────────────────────────────────────────────┐          │
│  │            使用习惯层                        │          │
│  │   定期备份 │ 命名规范 │ 文件夹组织            │          │
│  └────────────────────────────────────────────┘          │
└─────────────────────────────────────────────────────────┘
```

## 快速开始
### 30秒上手（创建领先个vault）
从零开始创建领先个Obsidian vault：

```text
步骤1：下载安装
1. 访问 https://obsidian.md
2. 下载对应平台版本（Windows/macOS/Linux）
3. 安装并启动Obsidian

步骤2：创建vault
4. 启动后选择"Create new vault"
5. Vault名称：MyVault（或任意名称）
6. 存储位置：建议选择云同步目录（如iCloud/Documents）
7. 点击"Create"

步骤3：界面熟悉
8. 左侧栏：文件列表（显示vault中的所有文件）
9. 中间：编辑区（撰写笔记的地方）
10. 右侧栏：标签面板、大纲等（可按需开启）
11. 顶部：工具栏（搜索、新建笔记等）
```

**vault存储位置建议**：

| 平台 | 推荐路径 | 说明 |
|------|----------|------|
| macOS | `~/Library/Mobile Documents/com~apple~CloudDocs/MyVault` | iCloud同步 |
| Windows | `C:\Users\用户名\OneDrive\Documents\MyVault` | OneDrive同步 |
| Linux | `~/Documents/MyVault` | 本地存储 |

### 60秒标准搭建（创建领先篇笔记）
创建领先篇结构化笔记：

```text
步骤1：新建笔记
12. 快捷键：Ctrl+N（Windows）/ Cmd+N（macOS）
13. 或点击左侧栏的"新建笔记"图标
14. 输入笔记名称：我的领先篇笔记

步骤2：撰写内容（使用Markdown语法）
```

```markdown
这是我使用Obsidian创建的领先篇笔记。Obsidian是一个强大的本地知识管理工具。

15. Markdown基础语法
16. 笔记的创建与保存
17. 基础界面操作

18. [ ] 学习更多Markdown语法
19. [ ] 配置核心选项
20. [ ] 创建日记笔记模板

21. [[Obsidian官方文档]]
22. [[Markdown语法速查]]
```

```text
步骤3：保存与预览
23. 快捷键：Ctrl+S（Windows）/ Cmd+S（macOS）保存
24. 切换预览：Ctrl+E（Windows）/ Cmd+E（macOS）
25. 笔记自动保存为.md文件到vault目录

步骤4：创建第二篇笔记并建立链接
26. 新建笔记：Obsidian官方文档
27. 在领先篇笔记中输入[[Obsidian官方文档]]，自动创建链接
28. 点击链接可跳转到目标笔记
```

### 120秒完整配置（核心配置项）
配置Obsidian的核心选项，优化使用体验：

> 详细代码示例已移至 `references/detail.md`

## 核心能力
## 依赖说明
**安装决策树**：

```text
你的操作系统是？
├── Windows
│   └── 下载 .exe 安装包 → 运行安装
├── macOS
│   └── 下载 .dmg 文件 → 拖拽到Applications
└── Linux
    ├── AppImage（推荐，免安装）
    ├── Snap：sudo snap install obsidian
    └── Flatpak：flatpak install flathub md.obsidian.Obsidian
```

**vault创建选项**：

| 选项 | 说明 | 适用场景 |
|------|------|----------|
| 创建新vault | 新建空vault | 全新开始 |
| 打开vault文件夹 | 打开已有.md文件目录 | 迁移已有笔记 |
| 从云存储创建 | 在iCloud/OneDrive等创建 | 多设备同步 |

**输入**: 用户提供依赖说明所需的指令和必要参数。
**处理**: 按照skill规范执行依赖说明操作,遵循单一意图原则。
**输出**: 返回依赖说明的执行结果,包含操作状态和输出数据。

### Markdown基础语法
**Markdown语法速查表**：
**处理流程**：解析用户输入的Markdown文本,执行语法转换,输出格式化的笔记内容。支持标题、列表、链接、代码块等元素的处理。


| 语法 | 说明 | 示例 |
|------|------|------|
| `# 标题` | 一级标题 | `# 大标题` |
| `## 标题` | 二级标题 | `## 中标题` |
| `### 标题` | 三级标题 | `### 小标题` |
| `- 内容` | 无序列表 | `- 项目1` |
| `1. 内容` | 有序列表 | `1. 领先项` |
| `[文本](URL)` | 外部链接 | `[官网](https://...)` |
| `[[笔记名]]` | 内部链接 | `[[我的笔记]]` |
| `> 引用` | 引用块 | `> 这是引用` |
| `` `代码` `` | 行内代码 | `` `code` `` |
| ```` ``` 
> 详细代码示例已移至 `references/detail.md`
text
步骤1：启用日记核心插件

输出结果包含操作状态和返回数据。
### 设置 → 核心插件 → 启用"
设置 → 核心插件 → 启用"日记"

**输入**: 用户提供设置 → 核心插件 → 启用"所需的指令和必要参数。
**处理**: 按照skill规范执行设置 → 核心插件 → 启用"操作,遵循单一意图原则。
**输出**: 返回设置 → 核心插件 → 启用"的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

步骤2：配置日记
### 设置 → 日记插件
设置 → 日记插件

**输入**: 用户提供设置 → 日记插件所需的指令和必要参数。
**处理**: 按照skill规范执行设置 → 日记插件操作,遵循单一意图原则。
**输出**: 返回设置 → 日记插件的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 日记存放位置
日记存放位置：DailyNotes

**输入**: 用户提供日记存放位置所需的指令和必要参数。
**处理**: 按照skill规范执行日记存放位置操作,遵循单一意图原则。
**输出**: 返回日记存放位置的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 日期格式
日期格式：YYYY-MM-DD

**输入**: 用户提供日期格式所需的指令和必要参数。
**处理**: 按照skill规范执行日期格式操作,遵循单一意图原则。
**输出**: 返回日期格式的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 模板文件位置
模板文件位置：Templates/daily

**输入**: 用户提供模板文件位置所需的指令和必要参数。
**处理**: 按照skill规范执行模板文件位置操作,遵循单一意图原则。
**输出**: 返回模板文件位置的执行结果,包含操作状态和输出数据。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

步骤3：创建日记模板
路径：Templates/daily.md
```

```markdown
# {{date}}

**输入**: 用户提供Markdown基础语法所需的指令和必要参数。
**处理**: 按照skill规范执行Markdown基础语法操作,遵循单一意图原则。
**输出**: 返回Markdown基础语法的执行结果,包含操作状态和输出数据。
- **LLM依赖**：需要LLM支持,由Agent平台内置LLM提供
- **API Key**：本skill无需额外API Key配置
- **可用性分类**：MD+EXEC（纯Markdown指令,部分功能需exec命令行执行）
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：新手入门与核心配、置免费版、含安装、领先篇笔记、核心配置与基础工、基础入门免费版是、新手入门指南、不同于综合工具箱、本技能聚焦、新手快速上手、安装配置、核心配置项、基础工作流、引导用户完成、的初次配置与基础、Use、when、模型调用、智能对话、应用时使用、不适用于需要、确定性的关键决策等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

## 今日任务
- [ ]

## 笔记
-

## 反思
-

## 明日计划
-
```

```text
步骤4：快速创建日记
- 点击左侧栏日历图标
- 或使用快捷键（默认无，可在设置中配置）
```

```markdown
type: meeting
date: 2026-07-18
time: 14:00
attendees:
  - 张三
  - 李四
tags: [meeting]
# 2026-07-18 项目评审会
## 议程
- 项目进展汇报
- 风险讨论
- 下一步规划

## 讨论内容
- 项目A进展顺利，预计按时完成
- 项目B存在资源瓶颈，需要协调

## 决策
- [ ] 项目A按原计划推进
- [ ] 项目B资源问题上报管理层

## 行动项
- [ ] @张三 完成项目A测试报告（截止：2026-07-20）
- [ ] @李四 协调项目B资源（截止：2026-07-22）
```

```markdown
type: project
created: 2026-07-18
status: active
tags: [project]
# 项目A
## 概述
[项目描述]

## 目标
- [ ] 目标1
- [ ] 目标2

## 关键决策
- [ ] 决策1

## 里程碑
| 里程碑 | 截止日期 | 状态 |
|--------|----------|------|
| 启动 | 2026-07-18 | 完成 |
| 中期 | 2026-08-15 | 进行中 |
| 完成 | 2026-09-30 | 待开始 |

## 相关链接
- [[会议记录]]
- [[需求文档]]
```

**安全使用习惯**：

| 习惯 | 说明 | 工具 |
|------|------|------|
| 定期备份 | 每周备份vault到云端 | 云同步或手动复制 |
| 命名规范 | 统一文件命名规则 | 日期前缀或主题前缀 |
| 文件夹组织 | 按主题或时间分目录 | Projects/Meetings/Daily |
| 标签使用 | 用标签分类笔记 | #project #meeting |
| 模板应用 | 使用模板保持结构一致 | Templates目录 |
| 链接建立 | 积极创建笔记间链接 | [[wikilink]] |

**推荐文件夹结构**：

```text
MyVault/
├── 00-Inbox/          # 临时笔记，待整理
├── 10-Daily/          # 日记笔记
├── 20-Meetings/       # 会议笔记
├── 30-Projects/       # 项目笔记
│   ├── ProjectA/
│   └── ProjectB/
├── 40-Knowledge/      # 知识库
│   ├── Architecture/
│   ├── Tools/
│   └── Learning/
├── 50-Archive/        # 归档笔记
├── 60-Templates/      # 模板
├── 70-Attachments/    # 附件（图片等）
└── 99-Meta/           # 元数据（仪表盘等）
```

**角色**：Obsidian新手

**场景描述**：从未使用过Obsidian，需要从下载安装到创建领先篇笔记的完整引导。

```text
1. 访问 obsidian.md 下载安装
2. 创建领先个vault（选择云同步目录）
3. 新建领先篇笔记（Ctrl+N）
4. 应用Markdown基础语法
5. 配置核心选项（文件与链接、编辑器）
6. 启用基础核心插件（日记、模板）
7. 建立文件夹结构
8. 创建领先篇日记笔记
```

**角色**：职场人士

**场景描述**：希望用Obsidian记录会议笔记，需要基础模板与工作流。

```text
1. 创建Templates文件夹
2. 创建会议笔记模板（含frontmatter）
3. 创建Meetings文件夹
4. 应用模板创建会议笔记
5. 使用wikilink关联相关项目笔记
6. 使用标签分类（#meeting #项目A）
```

**角色**：自我管理爱好者

**场景描述**：希望用Obsidian记录每日日记，培养反思习惯。

```text
1. 启用日记核心插件
2. 配置日记存放位置与日期格式
3. 创建日记模板（任务/笔记/反思）
4. 每天快速创建日记
5. 定期回顾过往日记
```

**角色**：项目经理

**场景描述**：用Obsidian管理项目文档，需要基础结构。

```text
1. 创建Projects文件夹
2. 为每个项目创建子文件夹
3. 创建项目主页笔记（概述/目标/里程碑）
4. 使用wikilink关联会议笔记与需求文档
5. 使用标签标记项目状态（#active #paused #done）

> 详细代码示例已移至 `references/detail.md`

### 30秒上手（创建领先个vault）
从零开始创建领先个Obsidian vault：

```text
步骤1：下载安装
- 访问 https://obsidian.md
- 下载对应平台版本（Windows/macOS/Linux）
- 安装并启动Obsidian

步骤2：创建vault
- 启动后选择"Create new vault"
- Vault名称：MyVault（或任意名称）
- 存储位置：建议选择云同步目录（如iCloud/Documents）
- 点击"Create"

步骤3：界面熟悉
- 左侧栏：文件列表（显示vault中的所有文件）
- 中间：编辑区（撰写笔记的地方）
- 右侧栏：标签面板、大纲等（可按需开启）
- 顶部：工具栏（搜索、新建笔记等）
```

**vault存储位置建议**：

| 平台 | 推荐路径 | 说明 |
|------|----------|------|
| macOS | `~/Library/Mobile Documents/com~apple~CloudDocs/MyVault` | iCloud同步 |
| Wi
```

## 错误处理

| 错误场景 | 原因 | 处理方式 |
|---------|------|---------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |

## 已知限制

- 当前版本仅支持中文交互
- 部分高级功能需要额外配置
- 输出结果需人工审核后使用
- 不支持离线运行模式
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力
## 常见问题

### Q1: Obsidian基础入门(免费版)支持哪些输入格式？
支持文本输入、文件上传和API调用三种方式。

### Q2: 使用Obsidian基础入门(免费版)需要什么环境？
需要支持SKILL.md的AI Agent平台，详见依赖说明。

### Q3: 输出结果可以直接使用吗？
输出结果建议人工审核后使用，确保符合具体业务需求。

## 示例

### 基本用法

**输入**：用户提供操作指令和必要参数

**输出**：返回执行结果,包含操作状态和输出数据

```text
用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功
```