AgentSkillsCN

getnote-to-obsidian

将Get笔记HTML导出文件夹转换为Obsidian可用的Markdown，包含YAML frontmatter、规范化标签和YYYY/MM文件夹组织。当迁移Get笔记导出、HTML笔记，或需要批量转换为Obsidian并生成索引.base时使用。

SKILL.md
--- frontmatter
name: getnote-to-obsidian
description: Convert Get笔记 HTML export folders into Obsidian-ready Markdown with YAML frontmatter, normalized tags, and YYYY/MM folder organization. Use when migrating Get笔记导出、HTML 笔记、或需要批量转换为 Obsidian 并生成索引 .base 的场景。

Get笔记 → Obsidian 转换 SOP

依赖

  • •Python 3
  • •markdownify（若缺失需安装）

脚本位置

  • •scripts/convert_to_obsidian.py

使用步骤

  1. •确认输入目录（Get笔记导出的 notes/ 目录）。
  2. •选择输出目录（必须是库内独立子目录，避免污染库根和 .base 过滤失效）。
    • •推荐目录名：get-note-obsidian/
  3. •执行脚本（可选生成索引 .base）。
  4. •抽查 1-2 篇笔记，确认 frontmatter 与标签解析正常。

执行示例

bash
python .codex/skills/getnote-to-obsidian/scripts/convert_to_obsidian.py \
  --input "/path/to/getnote/notes" \
  --output "/path/to/vault/get-note-obsidian" \
  --write-index

输出说明

  • •默认按 YYYY/MM 分文件夹（依据 created；缺失则用 HTML 文件修改时间；再缺失放 未分类时间）。
  • •生成 Obsidian Markdown：包含 title / created / tags / source(s) frontmatter。
  • •生成索引：<output>/get笔记索引.base（按标签分组，仅显示标题+标签）。
  • •.base 会限定在 file.inFolder("<output>")，所以输出目录必须是独立子目录。

标签规范

  • •自动拆分混合标签（如 #tag1, #tag2）。
  • •去除 # 前缀、中文/英文分隔符。
  • •非法字符（空格/括号等）统一替换为 -。
  • •数字开头会自动加 tag- 前缀。

常见问题

  • •frontmatter 不识别：确认文件首行是 --- 且为真实换行。
  • •标签不生效：检查标签是否含空格或括号（应被脚本自动规范化）。