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

# Markdown 转精美图片

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

## 核心特性

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

## 快速开始

### 基本用法

```bash
# 转换 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 元信息中提取嘉宾和主题：

**输入格式**：
```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` - 网络请求（备用）

首次使用需安装：
```bash
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 比例
- 自动分页
- 白色背景设计