Save To Obsidian Publish

Save web articles from multiple sources to Obsidian with auto summaries, tags, local images, duplicate detection, and optional user notes.

Save to Obsidian

Save web articles to Obsidian knowledge base with auto-generated summaries, tags, and local image storage.

Features

• ✅ Batch Processing: Process multiple article links at once
• ✅ Multi-source Support: WeChat, Zhihu, Juejin, Medium, blogs, etc.
• ✅ Smart Summary: Auto-generate structured summary (core idea + key points + audience)
• ✅ Auto Tags: Extract relevant tags (tech domain + topic type)
• ✅ Image Localization: Download images locally with relative paths
• ✅ Duplicate Detection: Skip already saved articles based on URL
• ✅ Retry on Failure: Auto-retry 3 times on network failure
• ✅ User Notes: Support adding personal notes

⚠️ Mandatory Rules

Image Paths — Relative Only

All images in the saved Markdown MUST use relative paths, never absolute URLs.

• ✅ Correct: ![图片](../attachments/{hash}/{filename}.png)
• ❌ Wrong: ![图片](https://mmbiz.qpic.cn/...)
• ❌ Wrong: ![图片](/absolute/path/to/attachments/...)

The script handles this automatically. If you process articles manually (e.g., due to anti-scraping), you must:

1. Download each image to ATTACHMENTS_DIR/{article_hash}/
2. Replace the URL with ../attachments/{article_hash}/{filename}
3. Verify images were actually saved (file size > 100 bytes)

This ensures Obsidian can display images offline and iCloud sync works correctly.

Usage

bash

# Single article
python3 save_article_to_obsidian.py "https://mp.weixin.qq.com/s/xxx"

# Multiple articles
python3 save_article_to_obsidian.py \
  "https://mp.weixin.qq.com/s/xxx" \
  "https://zhuanlan.zhihu.com/p/yyy"

# With notes
python3 save_article_to_obsidian.py "https://..." "My notes here"

Output Format

markdown

---
title: "Article Title"
url: "https://..."
created: 2026-04-07
source: wechat
tags:
  - ai
  - security
  - tutorial
---

## 📌 Summary

**Core Idea**: Article summary...

**Key Points**:
- Point 1
- Point 2
- Point 3

**Audience**: Target readers

🔗 [Read Original](https://...)

---

Article content...

Installation

1. Download the skill files
2. Configure paths in the script:

   python

   OBSIDIAN_DIR = os.path.expanduser("~/Documents/Obsidian/Articles")
   ATTACHMENTS_DIR = os.path.expanduser("~/Documents/Obsidian/attachments")
   

3. Ensure Python 3.7+ and curl are installed

Dependencies

• Python 3.7+
• curl

License

MIT