markdown-novel-viewer

Serve Markdown files as a book-like reader over HTTP with directory browsing.

2|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/NammDev/Goads-Krea --skill markdown-novel-viewer-nammdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-novel-viewer
Source: https://github.com/NammDev/Goads-Krea/tree/main/.claude/skills/markdown-novel-viewer
Command: npx skills add https://github.com/NammDev/Goads-Krea --skill markdown-novel-viewer-nammdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gray-matter, marked, highlight.js, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

View Markdown content in a distraction-free, book-like reading experience served over HTTP, enabling seamless long-form content consumption without distractions.

Core Features & Use Cases

  • Background HTTP server: renders Markdown files as a book-like reader with directory browsing.
  • Mermaid.js support: auto-renders Mermaid diagrams within Markdown.
  • Plan navigation and TOC: auto-detects plan structures and provides navigable sidebars and progress indicators.
  • Keyboard and mobile optimizations: keyboard shortcuts, focus reader mode, and mobile-friendly navigation for distraction-free reading.

Quick Start

Run the server with a Markdown file to start viewing it in a calm, book-like UI.

Frequently Asked Questions about markdown-novel-viewer

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

FAQPage Schema
How do I view markdown files in a distraction-free, book-like reader?

You can view markdown files in a distraction-free, book-like reader by running the background HTTP server, which renders long-form content locally and exposes routes for seamless navigation and reading.

Can I render Mermaid diagrams when viewing markdown over HTTP?

Yes, rendering Mermaid diagrams when viewing markdown over HTTP is supported automatically. The server parses and auto-renders Mermaid.js blocks within your markdown files without requiring extra configuration.

Does this markdown viewer support directory browsing for long-form documentation?

Yes, this markdown viewer supports directory browsing for long-form documentation. It exposes a dedicated /browse route that enables quick previews and seamless navigation across directories of markdown files.

Do I need Node.js and specific dependencies to serve markdown content?

Yes, you need Node.js to serve markdown content, as the HTTP server relies on dependencies like marked for markdown rendering, gray-matter for frontmatter parsing, and highlight.js for code highlighting.

What is the best way to navigate long-form novels and plans rendered as markdown?

The best way to navigate long-form novels and plans rendered as markdown is using the auto-detected TOC and plan navigation sidebars. It provides progress indicators, keyboard shortcuts, and mobile-friendly navigation for distraction-free reading.

Are there mobile optimizations for reading markdown reports served over HTTP?

Yes, there are mobile optimizations for reading markdown reports served over HTTP. The viewer includes mobile-friendly navigation, focus reader mode, and keyboard shortcuts to ensure a calm, book-like experience across devices.