以下是使用 Obsidian 将文章发布到 WordPress 的详细步骤及注意事项:
一、安装必要插件
1.Obsidian WordPress 插件
在 Obsidian 的插件市场搜索并安装 WordPress 插件(如 obsidian-wordpress 或社区推荐的其他版本)。
确保插件支持 XML-RPC 或 REST API 协议(推荐 REST API,安全性更高)。
图床插件(可选但建议)
2.安装 Image Auto Upload 插件
自动上传图片到图床(如腾讯云 COS 或其他存储服务),避免图片链接失效。
配置 PicGo 作为图床工具,确保与 Obsidian 插件联动。
二、配置 WordPress 账户
1.启用 WordPress 接口
XML-RPC:访问 你的WordPress域名/xmlrpc.php,若返回 XML 内容则已启用;若被禁用,需在后台关闭安全插件(如 Speed Optimizer、Perfmatters 等)的限制。
REST API:默认启用,建议使用 WordPress 5.6+ 版本,并为 Obsidian 创建专用用户。
2.创建专用用户与密码
在 WordPress 后台新增一个用户(角色设为“编辑”),并生成 应用程序密码(非登录密码,用于 API 鉴权)。
记录用户名、密码、WordPress 站点 URL,用于后续插件配置。
三、Obsidian 插件设置
连接 WordPress 账户
打开 Obsidian 的 WordPress 插件设置,填写以下信息:
API 类型:选择 XML-RPC 或 REST API(推荐 REST API)。
站点 URL:如 https://你的博客域名。
用户名和密码:WordPress 专用用户的账号和应用密码。
测试连接是否成功。
配置元数据与发布选项
在 Obsidian 笔记的 YAML 前置元数据中添加字段(如 title、tags、status),插件会自动同步到 WordPress。
支持选择发布为“草稿”或“直接发布”,建议首次测试时选择草稿。
四、发布流程
编辑与预览
在 Obsidian 中编写文章,使用 Markdown 格式,插入图片时通过 Image Auto Upload 自动上传到图床(路径会自动替换为图床链接)。
确保元数据完整(如分类、标签)。
一键发布
通过以下方式触发发布:
按 Ctrl+P 打开命令面板,输入 WordPress: 发布当前笔记。
在侧边栏启用插件按钮,点击发布。
发布成功后,元数据会添加 WordPress 文章 ID,便于后续编辑。
五、注意事项与问题排查
安全与兼容性
避免使用 XML-RPC(存在安全风险),优先选择 REST API 并启用应用程序密码。
若发布后元数据冲突(如与 Hexo 兼容),需手动调整插件配置或避免混合使用。
常见问题
图片无法显示:检查图床权限设置(如腾讯云 COS 需开启公共读)。
连接失败:确认 WordPress 接口已启用,或尝试更换 API 类型。
格式错乱:调整 Obsidian 主题或插件的导出规则,确保与 WordPress 主题兼容。
六、进阶优化
批量发布:通过插件命令批量上传多篇笔记(如 WordPress: 上传所有笔记)。
自动化同步:结合 GitHub Actions 或 Obsidian 插件实现定期自动发布。
多站点管理:为不同博客创建多个 WordPress 账户,灵活切换发布目标。
通过以上步骤,可高效实现 Obsidian 与 WordPress 的无缝衔接,兼顾创作自由与发布便捷性。若需进一步优化,可参考插件文档或社区教程(如知乎、CSDN 相关文章)。
发表回复