Show HN: SlideGauge – Static analyzer for Marp Markdown decks

1 point

8 months ago

I’ve been using Marp for slides since ChatGPT came out. It’s great for writing decks in Markdown, but the quality varies: too much text, inconsistent formatting, missing alt text, unreadable colors.

So I built SlideGauge.

What: A single-file, zero-dependency Python tool that scores Marp Markdown slides and reports concrete issues (length, bullets, lines, color/contrast, a11y, code blocks). Outputs JSON, text, or SARIF. Designed for AI agents and CI; useful for humans.

Why: Marp decks (especially AI-generated) often exceed readable limits or miss a11y basics. This lints them deterministically with actionable messages.

Try: uvx --from git+https://github.com/nibzard/slidegauge slidegauge example.md --text

Looking for feedback on rule defaults and additional formats.