Apple Notes Writer

将内容以完美格式写入Apple备忘录（macOS only）。

功能特性

• ✅ HTML格式支持 - 标题、列表、粗体、斜体等丰富格式
• ✅ Markdown转换 - 自动将Markdown转为Apple Notes支持的HTML
• ✅ 特殊字符转义 - 自动处理引号、反斜杠等棘手字符
• ✅ 文件夹管理 - 支持创建文件夹、指定目标文件夹
• ✅ 更新模式 - 可选择更新同名笔记或创建新笔记

使用方法

方式一：直接调用Python脚本

# 写入HTML格式内容
python scripts/apple_notes.py write \
    --title "我的笔记" \
    --content "\x3Cdiv>\x3Ch1>标题\x3C/h1>\x3Cp>内容\x3C/p>\x3C/div>"

# 从Markdown文件写入
python scripts/apple_notes.py write \
    --title "Markdown笔记" \
    --file content.md \
    --markdown

# 写入指定文件夹
python scripts/apple_notes.py write \
    --title "工作笔记" \
    --content "\x3Cdiv>\x3Cp>内容\x3C/p>\x3C/div>" \
    --folder "工作"

# 更新已存在的笔记
python scripts/apple_notes.py write \
    --title "我的笔记" \
    --content "\x3Cdiv>\x3Cp>新内容\x3C/p>\x3C/div>" \
    --update

# 读取笔记内容
python scripts/apple_notes.py read --title "我的笔记"

# 列出文件夹中的所有笔记
python scripts/apple_notes.py list --folder "工作"

# 创建新文件夹
python scripts/apple_notes.py create-folder --title "新项目"

方式二：在Python代码中使用

from scripts.apple_notes import AppleNotesWriter, markdown_to_html

# 创建写入器
writer = AppleNotesWriter(account="iCloud")

# 写入HTML内容
html_content = """\x3Cdiv>
\x3Ch1>会议记录\x3C/h1>
\x3Cp>时间：2024年3月28日\x3C/p>
\x3Cul>
    \x3Cli>讨论项目进度\x3C/li>
    \x3Cli>确定下周计划\x3C/li>
\x3C/ul>
\x3C/div>"""

result = writer.write(
    title="会议记录",
    content=html_content,
    folder="工作",
    update_existing=True
)
print(result)  # SUCCESS: Note created/updated - 会议记录

# Markdown转HTML后写入
markdown_text = """
# 学习笔记

## 重点内容

- **第一点**：非常重要
- *第二点*：次要内容

### 总结
这是总结段落。
"""

html = markdown_to_html(markdown_text)
writer.write(title="学习笔记", content=html)

支持的HTML标签

Apple Notes原生支持以下HTML标签：

HTML格式规范

✅ 正确示例

\x3Cdiv>
\x3Ch1>大标题\x3C/h1>
\x3Cp>这是一个段落，包含\x3Cb>粗体文字\x3C/b>和\x3Ci>斜体文字\x3C/i>。\x3C/p>
\x3Cul>
    \x3Cli>列表项1\x3C/li>
    \x3Cli>列表项2\x3C/li>
\x3C/ul>
\x3C/div>

❌ 错误示例

\x3C!-- 错误：没有外层div包裹 -->
\x3Ch1>标题\x3C/h1>
\x3Cp>内容\x3C/p>

\x3C!-- 错误：使用不支持的标签 -->
\x3Cdiv>
\x3Ccode>代码块\x3C/code>  \x3C!-- code标签不支持 -->
\x3Cimg src="...">    \x3C!-- img标签不支持 -->
\x3C/div>

\x3C!-- 错误：未闭合的标签 -->
\x3Cdiv>
\x3Cp>内容
\x3C/div>

Markdown转换规则

使用 markdown_to_html() 函数转换：

特殊字符与符号

自动转义的字符

脚本自动处理以下特殊字符：

推荐使用的特殊符号

Apple Notes完美支持以下Unicode符号：

触发词

当用户提到以下内容时，使用此技能：

工作流程

1. 确认需求 - 了解笔记主题、目标文件夹
2. 准备内容 - 用HTML格式组织内容，或使用Markdown转换
3. 转义字符 - 使用内置函数处理特殊字符
4. 执行写入 - 运行AppleScript创建/更新笔记
5. 验证结果 - 确认内容正确写入
6. 反馈用户 - 报告完成情况和笔记位置

高级用法

更新现有笔记

通过笔记ID更新已有笔记：

# 获取笔记ID后更新
note_id = "x-coredata://.../ICNote/p20"

script = f'''
tell application "Notes"
    set targetNote to note id "{note_id}"
    set body of targetNote to "{escaped_content}"
end tell
'''

subprocess.run(['osascript', '-e', script])

验证写入结果

verify_script = f'''
tell application "Notes"
    set targetNote to note id "{note_id}"
    return body of targetNote
end tell
'''
result = subprocess.run(['osascript', '-e', verify_script], 
                     capture_output=True, text=True)
print(result.stdout)  # 打印笔记内容验证

完整示例

示例1：记录会议纪要

from scripts.apple_notes import AppleNotesWriter

writer = AppleNotesWriter()

content = """\x3Cdiv>
\x3Ch1>产品评审会议纪要\x3C/h1>
\x3Cp>\x3Cb>时间：\x3C/b>2024年3月28日 14:00\x3C/p>
\x3Cp>\x3Cb>参会人：\x3C/b>张三、李四、王五\x3C/p>

\x3Ch2>讨论事项\x3C/h2>
\x3Cul>
    \x3Cli>确认Q2产品路线图\x3C/li>
    \x3Cli>讨论新功能优先级\x3C/li>
    \x3Cli>确定下周迭代计划\x3C/li>
\x3C/ul>

\x3Ch2>待办事项\x3C/h2>
\x3Cul>
    \x3Cli>\x3Cb>张三\x3C/b>：完成需求文档（3月30日前）\x3C/li>
    \x3Cli>\x3Cb>李四\x3C/b>：准备技术方案（4月1日前）\x3C/li>
\x3C/ul>

\x3Cp>---\x3C/p>
\x3Cp>\x3Ci>记录时间：2024-03-28 16:30\x3C/i>\x3C/p>
\x3C/div>"""

writer.write(
    title="产品评审会议纪要-20240328",
    content=content,
    folder="工作",
    update_existing=True
)

示例2：从Markdown文件批量导入

import os
from scripts.apple_notes import AppleNotesWriter, markdown_to_html

writer = AppleNotesWriter()
notes_dir = "/path/to/notes"

for filename in os.listdir(notes_dir):
    if filename.endswith('.md'):
        with open(os.path.join(notes_dir, filename), 'r') as f:
            markdown_content = f.read()
        
        html_content = markdown_to_html(markdown_content)
        title = filename.replace('.md', '')
        
        writer.write(
            title=title,
            content=html_content,
            folder="导入的笔记"
        )
        print(f"已导入: {title}")

注意事项

1. 仅支持macOS - 依赖AppleScript，Windows/Linux不可用
2. iCloud账户 - 默认使用iCloud账户，可修改account参数
3. 文件夹必须存在 - 写入前确保目标文件夹已创建
4. HTML标签限制 - 不支持\x3Ccode>、\x3Cimg>、\x3Ctable>等复杂标签
5. 内容长度限制 - 单条笔记建议不超过10MB

故障排查

问题：笔记创建成功但格式错乱

原因：HTML标签未闭合或不支持 解决：检查所有标签是否正确闭合，只使用支持的标签

问题：特殊字符显示异常

原因：引号或反斜杠未正确转义 解决：使用脚本内置的转义函数，不要手动转义

问题：找不到文件夹

原因：文件夹不存在或名称错误 解决：先用create-folder创建文件夹，或检查文件夹名称

问题：AppleScript执行失败

原因：权限问题或Apple Notes未运行 解决：确保Apple Notes已安装并至少运行过一次，检查自动化权限

依赖

• macOS 10.14+
• Python 3.7+
• Apple Notes.app

许可证

MIT License