markdown-to-image

name	markdown-to-image
description	将 Markdown 内容转换为精美的图片海报。特别适合将播客摘要、文章内容转为社交媒体分享图片。固定 3:4 比例，支持 YouTube 视频封面作为头图。触发词：「转图片」「Markdown 转图片」「生成海报」「生成分享图」「把这个转成图片」。

Markdown 转精美图片

将 Markdown 内容渲染为精美的分享海报图片，适合微信、小红书、微博等平台。

核心特性

• 固定 3:4 比例（1080×1440 像素）
• 自动分页 - 内容较多时生成多张图片
• 智能 SVG 头图 - 根据主题关键词自动生成相应风格的手绘线条图
• 智能标题 - 自动提取嘉宾名和主题，格式为「嘉宾：主题」
• 白色背景 + 大字体 - 清晰易读，专业排版
• 自适应布局 - 内容均匀分布，减少留白
• 宽字间距行间距 - 参考优秀海报排版

快速开始

基本用法

# 转换 Markdown 文件为图片（自动分页）
python3 scripts/md_to_image.py --file /path/to/content.md

# 指定输出目录
python3 scripts/md_to_image.py --file /path/to/content.md --output-dir /path/to/output

# 调整每页条目数
python3 scripts/md_to_image.py --file /path/to/content.md --items-per-page 4

参数说明

参数	说明	默认值
--file, -f	Markdown 文件路径	必填
--output-dir, -o	输出目录	attachments/MMDD
--width, -w	图片宽度（像素）	1080
--items-per-page	每页显示条目数	5

输出规格

• 比例: 固定 3:4（1080×1440 像素）
• 格式: PNG
• 分页: 自动根据内容生成多张图片
• 命名: page_1.png, page_2.png, ...
• 保存位置: 默认 attachments/MMDD（MMDD 为当日日期）

智能 SVG 头图

根据文章主题自动生成不同风格的 SVG 装饰图：

主题关键词	生成的 SVG 风格
AI、AGI、通用	神经网络节点 → 大脑 → 对话泡泡
开源、open source	开源符号 → 代码括号 → 分享图标
其他（默认）	麦克风 → 声波 → 人物对话

SVG 特点：

• 手绘风格，黑色线条白底
• 宽幅 16:9 比例
• 140px 高度，居中显示
• 底部带主题文字标签

智能标题提取

自动从 Markdown 元信息中提取嘉宾和主题：

输入格式：

# 播客名称

> **嘉宾**: Sebastian Raschka（LLM研究员）
> **主题**: 2025年AI技术趋势

输出标题：Sebastian Raschka：2025年AI技术趋势

Markdown 格式处理

格式	渲染效果
# 标题	自动提取并组合为「嘉宾：主题」
> **嘉宾**: ...	提取嘉宾名（移除 **）
> **主题**: ...	提取主题内容
**加粗**	红色加粗文字（移除 ** 标记）
1、2、3、	红色圆形数字编号
"引用内容"	蓝色高亮引用

工作流程

当用户请求将 Markdown 转为图片时：

1. 确定输入内容

   • 如果用户指定了文件路径，使用该文件
   • 如果用户当前打开了 Markdown 文件，默认使用该文件

2. 自动处理

   • 提取嘉宾和主题生成标题
   • 根据主题关键词生成相应 SVG 头图
   • 提取短版摘要（📱 短版摘要 部分）
   • 移除所有 ** markdown 标记，转为真正的加粗样式
   • 根据条目数量自动分页

3. 输出结果

   • 返回所有图片路径给用户
   • 图片保存在 attachments/MMDD 目录

常见用法

用户说	操作
「把这个转成图片」	转换当前打开的 Markdown 文件
「生成分享海报」	同上
「这个播客摘要转图片」	转换播客摘要文件
「Markdown 转图片」	同上

依赖

脚本依赖以下 Python 包：

• playwright - 浏览器自动化渲染
• markdown - Markdown 解析
• requests - 网络请求（备用）

首次使用需安装：

pip3 install playwright markdown requests
playwright install chromium

更新日志

v1.1 (2026-02-01)

• ✅ 智能 SVG 头图：根据主题关键词自动生成相应风格
• ✅ 智能标题：自动提取「嘉宾：主题」格式
• ✅ 移除 ** 标记：元信息和正文中的 markdown 加粗正确转换
• ✅ SVG 更大更醒目：140px 高度，600px 宽
• ✅ 优化排版：更大字体、更宽间距、自适应布局

v1.0 (2026-02-01)

• 初始版本
• 固定 3:4 比例
• 自动分页
• 白色背景设计