- name
- md-to-zhihu
- description
- Convert markdown articles to Zhihu (知乎) publishing format and one-click publish articles. Use when the user wants to publish markdown content to Zhihu, convert articles for Zhihu, or mentions 知乎、知乎专栏、知乎发布、发布到知乎.
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 自动提取为文章标题
- 段落，两端对齐
- 加粗、*斜体*、~~删除线~~
- 超链接（知乎支持跳转）
- 有序/无序列表，含嵌套
- 代码块（带语法高亮和语言标签）
- 行内代码
- 表格（带斑马纹）
- 引用块
- 分割线
- 图片（居中自适应，带图注）
- 脚注
- 任务列表
使用流程
方式一：预览 + 手动粘贴
- 执行转换命令，生成 HTML 文件
- 用浏览器打开生成的 HTML 文件
- 点击页面顶部「复制内容到剪贴板」按钮
- 在知乎文章编辑器中
Ctrl+V粘贴
方式二：一键自动发布
- 首次使用先运行
--login登录 - 执行发布命令，脚本自动完成发布
- 发布成功后会输出文章链接
注意事项
- 首次发布需要通过浏览器登录知乎，Cookie 会保存供后续使用
- Cookie 过期后需要重新登录（
--login） - 图片需使用可公开访问的 URL，本地图片需先上传到图床
- 发布前建议先用预览模式检查排版效果
- 知乎对文章长度有限制，超长文章建议分篇发布