markdown-to-image

Convert Markdown content into a PNG poster image using Puppeteer.

1|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/badDevBuild/md2poster-skill --skill markdown-to-image-baddevbuild
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-image
Source: https://github.com/badDevBuild/md2poster-skill/tree/main
Command: npx skills add https://github.com/badDevBuild/md2poster-skill --skill markdown-to-image-baddevbuild

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts Markdown content into a high-quality PNG poster image, removing the tedium of manual screenshotting and formatting.

Core Features & Use Cases

  • Uses markdown-to-poster and Puppeteer to render Markdown as a polished image.
  • Supports multiple themes for consistent visuals across notes, tutorials, and reports.
  • Example: generate a shareable poster from your project README or notes.

Quick Start

Run node render.js input.md output.png notion mobile to generate a poster image.

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 to a poster image for my project README?

You can convert Markdown to a poster image by running a Node.js command like `node render.js input.md output.png notion mobile`, which uses Puppeteer to launch a local Vite server, render the content, and capture a high-quality PNG file.

What is the process for turning Markdown documentation into a shareable PNG?

The process of turning Markdown into a shareable PNG involves applying themes via markdown-to-poster, rendering the styled content on a local Vite server, and capturing the page as a high-quality PNG using Puppeteer.

Do I need Node.js 18 to render Markdown content as an image?

Yes, Node.js 18 or higher is required to run the Puppeteer and Vite dependencies necessary to render Markdown content into a high-quality PNG poster image.

Can I apply different themes when converting Markdown to an image?

Yes, you can apply different themes when converting Markdown to an image by specifying the theme name as an argument in the render command, ensuring consistent visuals across notes, tutorials, and reports.

What's the best way to automate PNG generation from Markdown notes?

The best way to automate PNG generation from Markdown notes is using a Puppeteer-based script that programmatically launches a local Vite server to render the text content and capture a high-quality PNG without manual screenshotting.

Why does Markdown to image rendering launch a local Vite server?

Markdown to image rendering launches a local Vite server to provide a local environment for accurately applying themes and rendering the Markdown content into HTML before Puppeteer captures it as a high-quality PNG.