markdown-novel-viewer

Render Markdown files as book-like HTML pages over HTTP.

Updated Jun 16, 2025
One-click install
npx skills add https://github.com/Stonelukas/Mouse-on-Numpad --skill markdown-novel-viewer-stonelukas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-novel-viewer
Source: https://github.com/Stonelukas/Mouse-on-Numpad/tree/main/.opencode/skill/markdown-novel-viewer
Command: npx skills add https://github.com/Stonelukas/Mouse-on-Numpad --skill markdown-novel-viewer-stonelukas

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 files with a calm, book-like reading experience via an HTTP server, enabling distraction-free consumption of long-form content and documentation previews.

Core Features & Use Cases

  • Background HTTP server rendering markdown into a readable UI suitable for documents, plan notes, or lightweight novels.
  • Directory browser view to explore folders and quickly access Markdown files or referenced assets.
  • Code highlighting for fenced code blocks and Mermaid diagram support for inline visuals.
  • Simple Quick Start flow to preview markdown locally and share via a URL.

Quick Start

Start the server and open the URL in your browser.

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 as a clean, book-like HTML page over HTTP?

You can view markdown files over HTTP by starting a background server that renders the content into a distraction-free, book-like HTML reading experience. This enables simple local previewing and URL sharing for long-form documents.

Can I render Mermaid diagrams and highlight code blocks in a markdown viewer?

Yes, rendering markdown via an HTTP server can include Mermaid diagram support for inline visuals and highlight.js for code block highlighting. This ensures technical documentation remains readable and visually structured.

How do I browse directories to find markdown notes and documentation?

A directory browser view allows you to explore folders and quickly access Markdown files or referenced assets. This simplifies navigating large collections of documentation, plan notes, or lightweight novels.

Does this markdown viewer support frontmatter parsing for documentation previews?

Yes, the viewer requires gray-matter to parse frontmatter in your markdown files. This allows you to preview documentation locally while preserving metadata structures within a clean reading UI.

What is the best way to read long-form markdown novels without interface distractions?

The best way to read long-form markdown novels is using a background HTTP server that renders content into a calm, book-like HTML view. This provides a distraction-free consumption experience for lightweight literature.