markdown-to-image

Convert Markdown content into 3:4 poster images with Playwright.

333|83|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/zephyrwang6/myskill --skill markdown-to-image
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-image
Source: https://github.com/zephyrwang6/myskill/tree/main/markdown-to-image
Command: npx skills add https://github.com/zephyrwang6/myskill --skill markdown-to-image

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, markdown, requests, and includes scripts (resource) components.

What problem does it solve?

将 Markdown 内容转换为可直接分享的图片海报,解决将文本内容快速变成可在社交媒体传播的视觉素材的需求。

Core Features & Use Cases

  • 固定 3:4 比例(1080×1440 像素),适合在社交媒体上使用的封面格式。
  • 自动分页:内容较多时自动生成多张图片,避免信息拥挤。
  • 智能 SVG 头图:根据主题关键词自动生成风格化头图,提升视觉辨识度。
  • 智能标题提取:从元信息提取嘉宾与主题,生成清晰标题,便于续页呈现。
  • 自适应排版与大字设计:确保可读性和专业排版,适用于微信、小红书、微博等平台。
  • 快速工作流示例:通过命令行将 Markdown 转换为图片,输出到 attachments/MMDD 目录。

Quick Start

Use the following commands to convert a Markdown file to image posters:

  • 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

Frequently Asked Questions about markdown-to-image

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown content into shareable social media poster images?

Convert Markdown to poster images using the md_to_image.py script with a command like `python3 scripts/md_to_image.py --file /path/to/content.md`. The script renders your Markdown into fixed 3:4 aspect ratio images (1080×1440 pixels) optimized for social media platforms like WeChat, Little Red Book, and Weibo, automatically paginating lengthy content across multiple images.

Can I automatically generate multiple poster pages when my Markdown content is too long?

Yes, the Skill automatically paginates content across multiple images to prevent crowding. Use the `--items-per-page` parameter to control how much content appears per image, for example `python3 scripts/md_to_image.py --file content.md --items-per-page 4`, ensuring readable layouts across all generated posters.

Does this work for converting podcast summaries and article notes into visual social media content?

Yes, this Skill is built for exactly that use case. It transforms podcast summaries, articles, and blog notes into visually designed poster images with intelligent title extraction from metadata, styled SVG headers, and professional typography suitable for rapid social media distribution without manual design work.

What file formats and dependencies does the Markdown-to-image conversion require?

The Skill requires Markdown input files and depends on Playwright for rendering, the markdown library for parsing, and requests for optional YouTube cover support. It outputs PNG poster images to your specified output directory, with a default location of attachments/MMDD.

Can the Skill generate custom header images based on content topics?

Yes, the Skill includes intelligent SVG header generation that automatically creates styled headers based on topic keywords extracted from your Markdown metadata, improving visual distinction and branding across multiple poster pages.

How do I specify a custom output directory for generated poster images?

Use the `--output-dir` parameter to set a custom output path: `python3 scripts/md_to_image.py --file /path/to/content.md --output-dir /path/to/output`. If not specified, images default to the attachments/MMDD directory structure.