What problem does it solve?
This Skill solves the friction of reading long Markdown content by turning local .md files (or folders of them) into a calm, book-like web reader with navigation and focus-friendly UI.
Core Features & Use Cases
- Distraction-free novel reader UI: Warm theme, serif typography, progress bar, and an auto-hiding header for long-form reading.
- Mermaid diagram rendering: Converts fenced mermaid code blocks into diagrams and shows readable errors with source preview when rendering fails.
- Directory browsing for documentation: Browse a folder of files with clickable links, and jump into any Markdown document quickly.
- Plan-aware navigation: Detects plan.md structures, provides an accordion sidebar with phase status, and supports previous/next navigation across phases.
Quick Start
Start a local HTTP server to preview a Markdown file by running: node .claude/skills/markdown-novel-viewer/scripts/server.cjs --file ./README.md --open