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)