md-to-rednote

name	md-to-rednote
description	Convert Markdown articles into RedNote (小红书/Xiaohongshu) style image cards. Use when: generating social media images from markdown, creating rednote posts, converting blog posts to card-style images for rednote, xiaohongshu, 小红书, 图片卡片.
argument-hint	Provide the path to a Markdown file to convert

Markdown 转 RedNote（小红书）图片卡片

功能

将 Markdown 格式的文章自动拆分并渲染为多张 RedNote（小红书）风格的图片卡片（1080×1440），可直接用于发布。

支持特性：

• 基于像素高度的智能分页，内容密度均匀
• 标题保护机制（标题不会孤零零出现在页底）
• 手动分页标记 <!-- pagebreak -->
• 8 套配色主题
• 超过图片数量上限时自动缩小字号适配
• 任务列表（- [x]/- [ ]）渲染为复选框样式
• Emoji 完整支持
• 数学公式（LaTeX）支持

使用场景

• 将博客文章、学习笔记转为 RedNote 图文笔记
• 将技术文档转为易读的卡片式图片
• 批量生成统一风格的社交媒体内容图

使用方法

python .github/skills/md-to-rednote/scripts/convert.py <markdown_file> [--output <dir>] [--theme <name>] [--max-images <n>]

参数说明：

• markdown_file：输入的 Markdown 文件路径
• --output, -o：输出目录（默认：markdown 文件同目录下的 <文件名>_cards/）
• --theme, -t：配色主题（默认：warm）
• --max-images, -m：最大图片数量，超过会自动缩小字号（默认：18）

可选主题

• warm — 暖橙色调（默认）
• cool — 冷蓝色调
• green — 清新绿色调
• dark — 暗色主题
• xiaohongshu — RedNote 经典粉红
• zhihu — 知乎蓝
• notion — Notion 简约风
• douyin — 抖音暗色

依赖

• Python 3.10+
• markdown-it-py
• jinja2
• playwright（需安装 Chromium：playwright install chromium）

参考资源

• 转换脚本
• 封面模板
• 正文模板