marp-visual-fix

Diagnose and fix layout issues in Markdown-based Marp slides and themes.

3|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/ryo-touch/marp-skills --skill marp-visual-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: marp-visual-fix
Source: https://github.com/ryo-touch/marp-skills/tree/main/skills/marp-visual-fix
Command: npx skills add https://github.com/ryo-touch/marp-skills --skill marp-visual-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imagemagick, node, marp-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Marp slide designs often encounter display glitches and layout misalignments that degrade readability and export fidelity. This skill diagnoses those issues and provides targeted fixes to typography, element sizing, and overall slide composition.

Core Features & Use Cases

  • Diagnose text overflow, image sizing, and layout anomalies in Marp slides.
  • Propose multiple fix options (CSS tweaks, slide structure adjustments) and apply the chosen corrections.
  • Verify results by exporting a PNG and comparing visuals against the original.

Quick Start

Start by running a diagnostic pass on a Marp deck with display issues, then apply a recommended fix and verify the results.

Frequently Asked Questions about marp-visual-fix

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

FAQPage Schema
How do I fix text overflow and layout issues in Marp slides?

Fixing Marp slide layout involves diagnosing Markdown content and themes to apply targeted CSS tweaks and structural adjustments that resolve text overflow and element misalignment.

Why does my Marp PDF export have visual artifacts and display glitches?

PDF export artifacts in Marp often stem from typography or element sizing issues within your theme. Analyzing the Marp theme and slide structure helps propose fixes that improve export fidelity.

Do I need Node and ImageMagick installed to debug Marp slide displays?

Yes, diagnosing and verifying Marp slide visual fixes requires Node, ImageMagick, and marp-cli installed to process Markdown, apply CSS changes, and export PNG screenshots for comparison.

What is the best way to correct image sizing anomalies in Marp markdown?

Correcting image sizing in Marp requires analyzing your Markdown content and theme configuration to propose and implement targeted CSS adjustments that properly scale images within slide boundaries.

How do I verify visual fixes after adjusting a Marp theme?

You verify Marp theme visual fixes by exporting a PNG image of the corrected slide and comparing the output against the original layout to confirm the display glitches are resolved.

Can I use this approach to fix Marp slides for both screen display and PDF export?

Yes, diagnosing Marp slide composition through Markdown and theme analysis applies targeted fixes that resolve layout misalignments for both on-screen readability and PDF export fidelity.