README file from
GithubMarkPage Sync
一键将笔记（含图片）同步到 MarkPage —— 一个 Markdown 转精美图片的编辑器，让你的笔记变成适合社交媒体（小红书、Instagram、手机壁纸等）的精美视觉图。
安装
从社区插件安装（推荐）
在设置 → 社区插件中搜索 "MarkPage Sync"。
手动安装
- 从 最新发布 下载
main.js、manifest.json和styles.css - 放到你的仓库的
.obsidian/plugins/markpage-sync/文件夹 - 重启应用 → 设置 → 社区插件 → 启用 MarkPage Sync
使用方法
- 打开一篇笔记
- 点击左侧边栏的 ✈️ 图标，或按
Ctrl/Cmd+P搜索 "MarkPage" - 浏览器自动打开 MarkPage，笔记内容已就绪
命令
| 命令 | 说明 |
|---|---|
| 发送当前笔记到 MarkPage | 立即同步当前笔记 |
| 选择主题后发送到 MarkPage | 同步前先选择主题 |
功能特性
- 📝 完整 Markdown 内容同步
- 🖼️ 自动处理图片 —— 支持
![[image.png]]（维基链接）和两种格式 - 🎨 10 款内置主题
- 📄 自动提取 H1 标题作为封面标题
- ☁️ 支持任意 MarkPage 部署（Cloudflare Pages、自建等）
- 🔌 零依赖 —— 插件自带本地 HTTP 服务，无需额外软件
工作原理
插件在本地启动轻量级 HTTP 服务（默认端口 3001）。点击"发送"时，将笔记内容推送到该服务。MarkPage 网页端轮询获取内容并自动渲染。无需额外软件或服务器配置。
仓库中的图片直接从插件的 HTTP 服务读取 —— 无需 base64 编码，无需上传。
设置
| 设置项 | 默认值 | 说明 |
|---|---|---|
| MarkPage 网址 | https://markpage.timikays.us.kg |
MarkPage 实例地址 |
| 默认主题 | 无 | 同步时自动应用的主题 |
| 自动打开浏览器 | 开启 | 同步后自动在浏览器打开 MarkPage |
系统要求
- 桌面版 v0.15.0+
- 可访问 MarkPage 实例（在线或自建）
开发
npm install
npm run dev # 监听模式
npm run build # 生产构建
更新日志
v1.0.2
- 修复：过滤 frontmatter（
---包裹的 YAML 元数据），避免被当作正文渲染
v1.0.1
- 修复：图片路径编码问题（支持中文路径、空格等）
- 修复：重复图片去重
v1.0.0
- 初始发布
- 支持 Markdown 同步
- 支持图片自动处理
- 10 款内置主题
- 本地 HTTP 服务
许可证
MIT