Documentation

md2img usage guide

md2img turns Markdown into poster-style PNG images directly in the browser.

Editing

Write Markdown in the left editor. The preview updates immediately on the right side, or below the editor on small screens.

Render Modes

Long image renders all content as one poster. Automatic pagination splits by first-level headings, then falls back to ten-line chunks. Manual pagination uses a standalone --- separator.

Export

Hover a preview page to copy or download it. In paginated modes, the first page also offers download-all. Remote images must allow cross-origin access for browser export to succeed.

Themes

Use the toolbar to switch poster theme, fixed aspect ratio, and background opacity. Aspect ratio controls are available in paginated modes.

Troubleshooting

If export fails, first check whether the Markdown contains remote images. Browser canvas export requires those images to send permissive CORS headers.

Deployment

The app is a standard Next.js project. Run pnpm build before deploying, then deploy the repository to Vercel or any host that supports Next.js.