Obsidian Helper - Obsidian笔记助手#

激活词: Obsidian / 笔记 / 知识库 / 双向链接

工作原理#

通过操作Obsidian vault中的Markdown文件实现笔记管理。无需插件，直接读写 .md 文件。

功能#

1. 创建笔记#

bash

# 在 vault 中创建新笔记
echo "---\ntags: [idea, project]\ncreated: $(date)\n---\n\n# 新笔记\n\n正文内容" > vault/ideas/新笔记.md

2. 每日笔记#

python

import os
from datetime import datetime

VAULT = r"D:\Obsidian\main-vault"
today = datetime.now().strftime("%Y-%m-%d")
path = os.path.join(VAULT, "Daily", f"{today}.md")

if not os.path.exists(path):
    with open(path, "w", encoding="utf-8") as f:
        f.write(f"""---
created: {today}
tags: [daily]
---

# {today}

## 今日待办

- [ ]

## 笔记

## 反思
""")
    print(f"Created daily note: {path}")

3. 全文搜索#

python

import os, re

VAULT = r"D:\Obsidian\main-vault"

def search_notes(query: str, vault: str = VAULT):
    results = []
    for root, _, files in os.walk(vault):
        for f in files:
            if f.endswith(".md"):
                path = os.path.join(root, f)
                with open(path, encoding="utf-8", errors="ignore") as fh:
                    content = fh.read()
                    if query.lower() in content.lower():
                        results.append((path, content.count(query)))
    results.sort(key=lambda x: -x[1])
    return results

matches = search_notes("机器学习")
for path, count in matches[:10]:
    print(f"{count} hits: {path}")

4. 标签管理#

python

import os, re

VAULT = r"D:\Obsidian\main-vault"

def get_all_tags(vault: str = VAULT):
    tags = {}
    for root, _, files in os.walk(vault):
        for f in files:
            if f.endswith(".md"):
                path = os.path.join(root, f)
                with open(path, encoding="utf-8") as fh:
                    for m in re.finditer(r"#(\w[\w-]*)", fh.read()):
                        tag = m.group(1)
                        if tag not in ["obsidian"]:
                            tags[tag] = tags.get(tag, 0) + 1
    return sorted(tags.items(), key=lambda x: -x[1])

for tag, count in get_all_tags():
    print(f"#{tag}: {count} notes")

5. 双向链接检测#

python

import os, re

VAULT = r"D:\Obsidian\main-vault"

def find_backlinks(target: str, vault: str = VAULT):
    backlinks = []
    pattern = re.escape(f"[[{target}]]")
    for root, _, files in os.walk(vault):
        for f in files:
            if f.endswith(".md"):
                path = os.path.join(root, f)
                with open(path, encoding="utf-8") as fh:
                    if re.search(pattern, fh.read()):
                        backlinks.append(path)
    return backlinks

links = find_backlinks("机器学习")
for l in links:
    print(f"  ← {l}")

6. 图谱数据导出#

python

import os, re, json

VAULT = r"D:\Obsidian\main-vault"

def export_graph(vault: str = VAULT, output: str = "graph.json"):
    nodes, edges = [], []
    notes = [f.replace(".md", "") for f in os.listdir(vault) if f.endswith(".md")]
    for note in notes:
        path = os.path.join(vault, f"{note}.md")
        if os.path.isfile(path):
            with open(path, encoding="utf-8") as fh:
                content = fh.read()
            links = re.findall(r"\[\[([^\]]+)\]\]", content)
            for link in links:
                clean = link.split("|")[0].strip()
                if clean in notes:
                    edges.append({"source": note, "target": clean})
            nodes.append({"id": note, "group": 1})
    with open(output, "w") as f:
        json.dump({"nodes": nodes, "edges": edges}, f, ensure_ascii=False)
    print(f"Exported {len(nodes)} nodes, {len(edges)} edges to {output}")

export_graph()

使用场景#

1. 知识管理: Zettelkasten笔记法，原子笔记+双向链接
2. 每日笔记: 自动创建模板化日记，记录待办和反思
3. 关系探索: 导出图谱数据，发现知识间隐藏关联
4. 写作辅助: 跨笔记引用，构建长篇内容大纲
5. 标签审计: 清理冗余标签，统一标签体系

配置#

yaml

vault_path: "D:\\Obsidian\\main-vault"
daily_notes_dir: "Daily"
templates_dir: "Templates"
default_tags: [daily, auto]

依赖#

• Python 3.8+
• 本地 Obsidian vault