md-to-zhihu

Markdown 一键发布到知乎

将 Markdown 文章转换为知乎文章编辑器可接受的格式，支持多种排版风格预览，并可一键发布到知乎专栏。

快速使用

依赖安装

# 格式转换依赖
pip install markdown pygments beautifulsoup4

# 一键发布依赖（可选，仅发布时需要）
pip install playwright requests
playwright install chromium

格式转换（单篇）

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

参数说明：

参数	说明	默认值
input.md	输入的 Markdown 文件路径	必填
-o output.html	输出 HTML 文件路径	{input}_zhihu.html
--theme	主题风格	zhihu
--content-only	仅输出纯净 HTML 内容（用于 API 发布）	否
--dir	批量转换：指定目录路径	-

批量转换（整个目录）

# 转换目录下所有 .md 文件
python ~/.cursor/skills/md-to-zhihu/scripts/convert.py --dir ./articles

# 批量转换，指定主题
python ~/.cursor/skills/md-to-zhihu/scripts/convert.py --dir ./articles --theme tech

一键发布（单篇）

# 首次使用：登录知乎并保存 Cookie
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py --login

# 发布文章
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py input.md

# 保存为草稿
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py input.md --draft

# 指定标题和话题
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py input.md --title "文章标题" --topic "AI,编程"

批量发布（整个目录）

# 批量发布目录下所有 .md 文件
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py --dir ./articles

# 批量保存为草稿
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py --dir ./articles --draft

# 批量发布，设置话题和自定义间隔（默认60s）
python ~/.cursor/skills/md-to-zhihu/scripts/publish.py --dir ./articles --topic "AI,编程" --delay 30

参数	说明	默认值
--dir	批量发布：指定目录路径，发布所有 .md	-
--delay	每篇文章发布间隔秒数（防限流）	60
--draft	仅保存为草稿	否
--topic	文章话题，逗号分隔	-

可用主题

• zhihu (知乎蓝)：知乎官方蓝色调，专业简洁，推荐默认使用
• elegant (优雅灰)：深灰色调，沉稳大气，适合深度长文
• tech (科技紫)：紫色/靛蓝色调，现代科技感，适合技术文章
• warm (温暖橙)：橙色暖色调，活泼亲和，适合故事/经验分享
• nature (自然绿)：绿色清新调，自然舒适，适合科普/生活文章

支持的 Markdown 元素

• 标题 (h1-h4)，h1 自动提取为文章标题
• 段落，两端对齐
• 加粗、斜体、删除线
• 超链接（知乎支持跳转）
• 有序/无序列表，含嵌套
• 代码块（带语法高亮和语言标签）
• 行内代码
• 表格（带斑马纹）
• 引用块
• 分割线
• 图片（居中自适应，带图注）
• 脚注
• 任务列表

使用流程

方式一：预览 + 手动粘贴

1. 执行转换命令，生成 HTML 文件
2. 用浏览器打开生成的 HTML 文件
3. 点击页面顶部「复制内容到剪贴板」按钮
4. 在知乎文章编辑器中 Ctrl+V 粘贴

方式二：一键自动发布

1. 首次使用先运行 --login 登录
2. 执行发布命令，脚本自动完成发布
3. 发布成功后会输出文章链接

注意事项

• 首次发布需要通过浏览器登录知乎，Cookie 会保存供后续使用
• Cookie 过期后需要重新登录（--login）
• 图片需使用可公开访问的 URL，本地图片需先上传到图床
• 发布前建议先用预览模式检查排版效果
• 知乎对文章长度有限制，超长文章建议分篇发布