Notes Export Api — Notes 导出 API

便签导出 API

直接调用导出 API 做便签导出，不在本地重写渲染逻辑。

开源地址：https://github.com/zhaoolee/notes

工作流 使用 scripts/导出_note.sh。 传入 --markdown-file 或 --markdown。 若使用 --markdown-file，脚本会自动扫描 Markdown 内的本地图片引用： !alt !alt 对本地图片调用同源后端 /API/images/导入 获取 URL，并把 Markdown 中的图片路径替换成可访问 URL。 再把替换后的 Markdown 提交到 /API/导出。 传入 --输出。 只有在调用方明确指定主题时才传 --theme；否则直接使用默认的 default（暖白纸感），不要为了主题再追问用户。 默认优先使用本地生产入口 http://127.0.0.1:18080/API/导出；探测不到时回退到 https://notes.fangyuanxiaozhan.com/API/导出。 若需切换导出服务地址，可在仓库根目录 .env 或 技能s/notes-导出-API/.env 中设置： NOTES_导出_API_BASE_URL=http://127.0.0.1:18080 # 或显式指定线上地址 NOTES_导出_API_BASE_URL=https://notes.fangyuanxiaozhan.com

主题约定 default: 暖白纸感。默认主题；调用方未声明时使用它。 smartisan-dark: 锤子暗黑。仅在调用方明确要求暗色或暗黑主题时使用。 脚本用法 技能s/notes-导出-API/scripts/导出_note.sh \ --markdown-file /abs/path/to/note.md \ --输出 /abs/path/to/note.png

如果 note.md 中包含本地图片，例如：

0x01

配图如下：

!示意图

脚本会先上传 ./images/demo.png，再把 Markdown 中的图片链接替换成后端返回的 URL，最后导出 PNG。

技能s/notes-导出-API/scripts/导出_note.sh \ --markdown '## 0x01\n正文内容' \ --输出 /abs/path/to/note.png

技能s/notes-导出-API/scripts/导出_note.sh \ --markdown-file /abs/path/to/note.md \ --theme smartisan-dark \ --输出 /abs/path/to/note-dark.png

注意事项 本地 Markdown 文件按 UTF-8 读取。 --markdown-file 模式会自动处理本地图片；--markdown 内联文本模式不会解析相对路径图片，内联模式下请直接传可访问 URL。 --theme 是可选参数；不传时默认使用 default。 默认优先探测本地生产入口 http://127.0.0.1:18080/API/导出；若本地服务不可用，则回退到 https://notes.fangyuanxiaozhan.com/API/导出。 .env 中的 NOTES_导出_API_BASE_URL 优先级高于自动探测结果。 命令行 --端点 优先级仍然最高。 若 .env 提供的是站点根地址，脚本会自动补上 /API/导出。 图片导入接口会从同一个后端地址推导得到：若导出地址是 /API/导出，图片导入地址会自动改为 /API/images/导入。 本地图片路径支持相对 Markdown 文件的相对路径、绝对路径，以及 file:// 路径。 若 Markdown 中引用的本地图片不存在，脚本会直接报错并停止导出。 遇到非 200 响应时，直接把错误返回给调用方。