🚀 Obsidian 到 WordPress 自动化发布脚本使用指南

为了实现“在本地 Obsidian 写作，一键无缝推送到云端 WordPress”的极客工作流，我们深度定制了一个自动化发布脚本。这份文档记录了该脚本的各项超级能力以及正确的使用姿势。

🌟 核心功能特性

1. 自动识别并转换 Markdown：支持将 Obsidian 里的 Markdown 语法无缝转换为 WordPress 兼容的 HTML。
2. 极客风代码高亮 (带一键复制)：自动识别代码块，在网页上生成类似 Mac 风格的深色代码框，带行号，右上角自带“Copy”一键复制按钮。
3. 本地图片全自动上传：自动扫描文章里的本地图片路径，静默上传至 WordPress 媒体库，并将文章中的本地链接替换为云端 URL。
4. 全自动 SEO (搜索引擎优化)：
5. 自动提取文章头部的 description 字段，推送到 WordPress 的 Rank Math SEO 插件。
6. 自动保留图片的 ![Alt文本] 并将其作为网页图片底层的 SEO 描述。
7. 智能双向分类映射：
8. 自动读取文章的分类数组并匹配到网站后台。如果遇到网站不存在的全新分类，脚本会全自动为您创建！

---

📝 写作与排版规范

为了让脚本能 100% 发挥威力，请在写文章时遵循以下规范：

1. 必填的文章头部 (Frontmatter)

文章最顶部必须包含 YAML 属性。title 和 description 直接决定网页标题和 Google 搜索摘要；categories 决定文章分类：

---
title: "您的文章标题"
description: "给搜索引擎看的文章摘要，非常重要！"
categories: [教程, 效率工具, Obsidian技巧]
---

(注：如果填写的分类在网站上不存在，脚本发文时会自动帮您在后台建好。)

2. 插入图片

直接使用 Obsidian 的标准图片插入方式，但强烈建议加上方括号里的说明（这会自动变成网页图片的 Alt 标签，对图片 SEO 极有帮助）：

![这是这幅画的说明，有助于百度收录](图片名字.png)

3. 插入代码块

直接使用三个反引号，并跟上语言名称（比如 python, javascript），网页端就会自动渲染出炫酷的黑框高亮：

print("Hello World")

---

⚡ 如何一键发布？

通过 Obsidian 快捷键 (Shell Commands) 联动

1. 确保在 Obsidian 安装并启用了 Shell commands 插件。
2. 进入插件设置，点击 New command (新建命令)。
3. 将下面的终端指令完全复制进去：
   bash
python C:\Users\livew\.gemini\config\skills\publish_hugo_to_wp\scripts\push_to_wp.py "{{file_path:absolute}}"
4. （强烈建议）在 Obsidian 的快捷键设置中，为这个 Shell Command 绑定一个专属快捷键（如 Ctrl + Shift + P）。
5. 发布流程：写完文章后，直接按下快捷键。底层脚本会瞬间被唤醒，帮您把图片传好、代码框渲染好、SEO 和分类设置好，并直接发布到网站！

---

💡 维护说明：该核心脚本安全存放在您的本地隐私目录：C:\Users\livew\.gemini\config\skills\publish_hugo_to_wp\scripts\push_to_wp.py。

▲