One-Click Publish Markdown to Zhihu

Quick Start

Dependency Installation

# Dependencies for format conversion
pip install markdown pygments beautifulsoup4

# Dependencies for one-click publishing (optional, required only for publishing)
pip install playwright requests
playwright install chromium

Format Conversion (Single Article)

python ~/.cursor/skills/md-to-zhihu/scripts/convert.py input.md

input.md

-o output.html

{input}_zhihu.html

--theme

zhihu

--content-only

--dir

Batch Conversion (Entire Directory)

# Convert all .md files in the directory
python ~/.cursor/skills/md-to-zhihu/scripts/convert.py --dir ./articles

# Batch conversion with specified theme
python ~/.cursor/skills/md-to-zhihu/scripts/convert.py --dir ./articles --theme tech

One-Click Publishing (Single Article)

# First-time use: Log in to Zhihu and save Cookie
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py --login

# Publish article
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py input.md

# Save as draft
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py input.md --draft

# Specify title and topics
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py input.md --title "Article Title" --topic "AI,Programming"

Batch Publishing (Entire Directory)

# Batch publish all .md files in the directory
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py --dir ./articles

# Batch save as drafts
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py --dir ./articles --draft

# Batch publish with specified topics and custom interval (default 60s)
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py --dir ./articles --topic "AI,Programming" --delay 30

--dir

--delay

60

--draft

--topic

Available Themes

• zhihu (Zhihu Blue): Zhihu's official blue tone, professional and concise, recommended for default use
• elegant (Elegant Gray): Dark gray tone, calm and grand, suitable for in-depth long articles
• tech (Tech Purple): Purple/indigo tone, modern tech feel, suitable for technical articles
• warm (Warm Orange): Warm orange tone, lively and approachable, suitable for stories/experience sharing
• nature (Natural Green): Fresh green tone, natural and comfortable, suitable for popular science/life articles

Supported Markdown Elements

• Headings (h1-h4), h1 is automatically extracted as the article title
• Paragraphs, justified alignment
• Bold, italic, strikethrough
• Hyperlinks (Zhihu supports redirection)
• Ordered/unordered lists, including nested lists
• Code blocks (with syntax highlighting and language labels)
• Inline code
• Tables (with zebra stripes)
• Blockquotes
• Horizontal rules
• Images (centered and adaptive, with captions)
• Footnotes
• Task lists

Usage Workflow

Method 1: Preview + Manual Paste

1. Execute the conversion command to generate an HTML file
2. Open the generated HTML file in a browser
3. Click the "Copy content to clipboard" button at the top of the page
4. Paste using

   Ctrl+V

   in the Zhihu article editor

Method 2: One-Click Automatic Publishing

1. Run

   --login

   to log in for the first use
2. Execute the publishing command, and the script will complete publishing automatically
3. The article link will be output after successful publishing

Notes

• First-time publishing requires logging in to Zhihu via browser, and the Cookie will be saved for subsequent use
• Re-login with

  --login

  is required when the Cookie expires
• Images must use publicly accessible URLs; local images need to be uploaded to an image hosting service first
• It is recommended to check the typesetting effect in preview mode before publishing
• Zhihu has limits on article length; it is recommended to split extra-long articles into multiple parts for publishing