Back to Details

obsidian-skills

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Obsidian Skills

Obsidian 技能

Agent skills for creating and editing Obsidian-compatible plain text files, following the Agent Skills specification.
遵循Agent Skills规范，用于创建和编辑Obsidian兼容纯文本文件的Agent技能。

When to Use This Skill

何时使用此技能

  • Creating Obsidian notes with proper formatting
  • Building knowledge bases with wikilinks
  • Creating canvas files for visual organization
  • Working with Obsidian Bases (databases)
  • Managing PKM (Personal Knowledge Management) systems
  • Zettelkasten-style note-taking
  • 创建格式规范的Obsidian笔记
  • 构建包含维基链接的知识库
  • 创建用于可视化组织的Canvas文件
  • 操作Obsidian Bases（数据库）
  • 管理PKM（个人知识管理）系统
  • 采用Zettelkasten风格记笔记

Supported File Types

支持的文件类型

1. Obsidian Flavored Markdown (.md)

1. Obsidian Flavored Markdown (.md)

Standard markdown with Obsidian extensions:
markdown
undefined
标准Markdown加上Obsidian扩展：
markdown
undefined

Note Title

Note Title

Regular markdown content with [[wikilinks]] to other notes.
Regular markdown content with [[wikilinks]] to other notes.

Features

Features

  • [[Internal Links]]
  • [[Links with Alias|Custom Text]]
  • ![[Embedded Notes]]
  • ![[image.png]]
  • #tags and #nested/tags
  • ^block-references
  • %%comments%%
  • [[Internal Links]]
  • [[Links with Alias|Custom Text]]
  • ![[Embedded Notes]]
  • ![[image.png]]
  • #tags and #nested/tags
  • ^block-references
  • %%comments%%

Frontmatter

Frontmatter

title: Note Title date: 2025-01-12 tags: [tag1, tag2] aliases: [alias1, alias2]

undefined

title: Note Title date: 2025-01-12 tags: [tag1, tag2] aliases: [alias1, alias2]

undefined

2. Obsidian Bases (.base)

2. Obsidian Bases (.base)

Database-like views for notes:
json
{
  "type": "base",
  "version": 1,
  "name": "Projects Database",
  "source": "folder:Projects",
  "columns": [
    {"name": "Name", "type": "text", "property": "file.name"},
    {"name": "Status", "type": "select", "property": "status"},
    {"name": "Due Date", "type": "date", "property": "due"},
    {"name": "Priority", "type": "number", "property": "priority"}
  ],
  "filters": [
    {"property": "status", "operator": "!=", "value": "done"}
  ],
  "sorts": [
    {"property": "due", "direction": "asc"}
  ]
}
类数据库视图的笔记展示：
json
{
  "type": "base",
  "version": 1,
  "name": "Projects Database",
  "source": "folder:Projects",
  "columns": [
    {"name": "Name", "type": "text", "property": "file.name"},
    {"name": "Status", "type": "select", "property": "status"},
    {"name": "Due Date", "type": "date", "property": "due"},
    {"name": "Priority", "type": "number", "property": "priority"}
  ],
  "filters": [
    {"property": "status", "operator": "!=", "value": "done"}
  ],
  "sorts": [
    {"property": "due", "direction": "asc"}
  ]
}

3. JSON Canvas (.canvas)

3. JSON Canvas (.canvas)

Visual canvas for spatial organization:
json
{
  "nodes": [
    {
      "id": "1",
      "type": "text",
      "text": "Main Idea",
      "x": 0,
      "y": 0,
      "width": 200,
      "height": 100
    },
    {
      "id": "2",
      "type": "file",
      "file": "Notes/Related Note.md",
      "x": 300,
      "y": 0,
      "width": 200,
      "height": 100
    }
  ],
  "edges": [
    {
      "id": "e1",
      "fromNode": "1",
      "toNode": "2",
      "label": "relates to"
    }
  ]
}
用于空间化组织的可视化画布：
json
{
  "nodes": [
    {
      "id": "1",
      "type": "text",
      "text": "Main Idea",
      "x": 0,
      "y": 0,
      "width": 200,
      "height": 100
    },
    {
      "id": "2",
      "type": "file",
      "file": "Notes/Related Note.md",
      "x": 300,
      "y": 0,
      "width": 200,
      "height": 100
    }
  ],
  "edges": [
    {
      "id": "e1",
      "fromNode": "1",
      "toNode": "2",
      "label": "relates to"
    }
  ]
}

Common Tasks

常见任务

Create a New Note

创建新笔记

Create an Obsidian note about [topic]
Include: frontmatter, sections, relevant links
Create an Obsidian note about [topic]
Include: frontmatter, sections, relevant links

Build a MOC (Map of Content)

构建MOC（内容地图）

Create a Map of Content for [topic]
Link to: existing notes in vault
Structure: hierarchical with categories
Create a Map of Content for [topic]
Link to: existing notes in vault
Structure: hierarchical with categories

Create a Daily Note

创建每日笔记

Create daily note for today
Include: tasks, meetings, notes sections
Template: my-daily-template
Create daily note for today
Include: tasks, meetings, notes sections
Template: my-daily-template

Design a Canvas

设计画布

Create a canvas for [project/concept]
Nodes: key ideas, files, images
Connections: relationships between nodes
Create a canvas for [project/concept]
Nodes: key ideas, files, images
Connections: relationships between nodes

Create a Database View

创建数据库视图

Create a Base for tracking [items]
Columns: [properties to track]
Filters: [criteria]
Sort: [ordering]
Create a Base for tracking [items]
Columns: [properties to track]
Filters: [criteria]
Sort: [ordering]

Obsidian Syntax Reference

Obsidian语法参考

Links

链接

SyntaxDescription
[[Note]]
Internal link
[[Note|Alias]]
Link with alias
[[Note#Heading]]
Link to heading
[[Note#^block]]
Link to block
![[Note]]
Embed note
![[image.png]]
Embed image
Syntax描述
[[Note]]
内部链接
[[Note|Alias]]
带别名的链接
[[Note#Heading]]
链接到标题
[[Note#^block]]
链接到块引用
![[Note]]
嵌入笔记
![[image.png]]
嵌入图片

Tags

标签

SyntaxDescription
#tag
Simple tag
#parent/child
Nested tag
tags: [a, b]
Frontmatter tags
Syntax描述
#tag
普通标签
#parent/child
嵌套标签
tags: [a, b]
前置元数据标签

Callouts

Callouts

markdown
> [!note] Title
> Content

> [!warning] Important
> Warning content

> [!tip] Pro tip
> Helpful information
markdown
> [!note] 标题
> 内容

> [!warning] 重要提示
> 警告内容

> [!tip] 专业技巧
> 实用信息

Tasks

任务

markdown
- [ ] Incomplete task
- [x] Completed task
- [ ] Task with [[link]]
- [ ] Task #tag
- [ ] Task 📅 2025-01-12
markdown
- [ ] 未完成任务
- [x] 已完成任务
- [ ] 带[[链接]]的任务
- [ ] 带#标签的任务
- [ ] 带📅 2025-01-12截止日期的任务

Dataview Queries

Dataview查询

markdown
```dataview
TABLE status, due
FROM "Projects"
WHERE status != "done"
SORT due ASC
undefined
markdown
```dataview
TABLE status, due
FROM "Projects"
WHERE status != "done"
SORT due ASC
undefined

Templates

模板

Note Template

笔记模板

markdown
---
created: {{date}}
tags: []
---
markdown
---
created: {{date}}
tags: []
---

{{title}}

{{title}}

Overview

概述

Details

详情

Related

相关

undefined
undefined

Meeting Note

会议笔记模板

markdown
---
date: {{date}}
attendees: []
type: meeting
---
markdown
---
date: {{date}}
attendees: []
type: meeting
---

Meeting: {{title}}

会议：{{title}}

Attendees

参会人员

Agenda

议程

Notes

会议记录

Action Items

行动项

  • [ ]
undefined
  • [ ]
undefined

Integration with PKM Systems

与PKM系统的集成

Zettelkasten

Zettelkasten

markdown
undefined
markdown
undefined

202501121030 Atomic Note Title

202501121030 Atomic Note Title

Brief atomic concept.
Brief atomic concept.

Links

Links

  • [[202501121025 Related Concept]]
  • [[202501121035 Another Idea]]
  • [[202501121025 Related Concept]]
  • [[202501121035 Another Idea]]

References

References

  • Source material
undefined
  • Source material
undefined

PARA Method

PARA方法

/vault
├── 1 Projects/
├── 2 Areas/
├── 3 Resources/
└── 4 Archive/
/vault
├── 1 Projects/
├── 2 Areas/
├── 3 Resources/
└── 4 Archive/

Best Practices

最佳实践

  1. Atomic Notes: One idea per note
  2. Descriptive Titles: Clear, searchable names
  3. Liberal Linking: Connect related concepts
  4. Consistent Frontmatter: Use templates
  5. Regular Review: Maintain connections
  1. 原子化笔记：每个笔记只包含一个观点
  2. 描述性标题：清晰、便于搜索的名称
  3. 大量链接：关联相关概念
  4. 统一前置元数据：使用模板
  5. 定期回顾：维护关联关系

Credits

致谢

Created by kepano (Steph Ango, CEO of Obsidian). Licensed under MIT.
由kepano（Obsidian CEO Steph Ango）创建。基于MIT许可证开源。