update-blog-by-siyuan

Original：🇨🇳 Chinese

Translated

Sync articles from SiYuan Note to Hexo blog — search, transform, copy images, and deploy. Use when the user asks to publish or sync a SiYuan document to the blog.

4installs

Sourceq7h2q9/other_skills

Added on2026-04-04

NPX Install

npx skill4agent add q7h2q9/other_skills update-blog-by-siyuan

SKILL.md Content (Chinese)

View Translation Comparison →

sync-siyuan — Sync SiYuan Note to Hexo Blog

Sync and publish SiYuan Note documents to Hexo Butterfly blog, including content conversion and image copying.

Pre-check

SiYuan MCP is available:
```
mcp__siyuan-mcp__unified_search
```
can be called normally
Blog directory exists:
```
source/_posts/
```
is accessible
Image directory exists:
```
source/post_imgs/
```
is accessible
SiYuan data directory is accessible:
```
D:/299792458/Q7h2q9/data/assets/
```

If the above conditions are not met: Prompt the user to check whether SiYuan is running, MCP is configured, and the path is correct.

Usage

/sync-siyuan <document title>

Parameter:

$ARGUMENTS

— SiYuan document title (fuzzy matching supported)

Key Paths

Purpose	Path
SiYuan assets	`D:/299792458/Q7h2q9/data/assets/`
Blog post directory	`D:/299792458/blog/butterfly/source/_posts/`
Blog image directory	`D:/299792458/blog/butterfly/source/post_imgs/`

Workflow

1. Search for SiYuan Documents

Use

mcp__siyuan-mcp__unified_search

:

```
filename
```
: "$ARGUMENTS"
```
types
```
:
```
["d"]
```

No results → Inform the user that no matching document is found, end the process. Multiple results → List all results for the user to select.

2. Read Document Content

Use

mcp__siyuan-mcp__get_document_content

to read the complete Markdown content.

3. Process Content

Execute in order:

Remove the first-level heading (
```
# xxx
```
) — Hexo uses frontmatter title
Remove SiYuan frontmatter (if any)
Clean up zero-width characters:
```
\u200b
```
,
```
\u200d
```
,
```
\u200c
```
,
```
\uFEFF
```
Extract all image references, collect the list of image filenames (used in step 4)
Replace image path:
```
assets/xxx.png
```
→
```
post_imgs/xxx.png
```

Image reference format example:

Original SiYuan format:

![image](assets/image-20260305161734-22rhrm8.png)

Converted format:

![image](post_imgs/image-20260305161734-22rhrm8.png)

4. Copy Images

For each image filename collected in step 3:

bash

cp "D:/299792458/Q7h2q9/data/assets/<filename>" "D:/299792458/blog/butterfly/source/post_imgs/<filename>"

Check if the source file exists before copying, warn the user if it does not exist (do not interrupt the process)
Skip if the target file already exists (to avoid duplicate copying)
Batch copy, process multiple files with one command

5. Check for Existing Article in Blog

Search for .md files with the same or related names under

source/_posts/

.

6. Generate/Update Blog Article

New Article

Generate frontmatter:

yaml

---
title: <document title>
cover:
categories:
tags:
date: <current time YYYY-MM-DD HH:mm:ss>
lastmod: <SiYuan document update time>
---

Write to

source/_posts/<document title>.md

. Remind the user to fill in cover, categories and tags.

Update Existing Article

Keep the original frontmatter (title, cover, categories, tags, abbrlink, date)
Only update lastmod
Replace the body content
Copy newly added images as well

7. Deploy (Optional)

Ask the user whether to deploy immediately. If yes: