markdown-novel-viewer

Convert Markdown to HTML with syntax highlighting and a navigable TOC.

1|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/hoanghd218/tranvanhoang.com --skill markdown-novel-viewer-hoanghd218
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-novel-viewer
Source: https://github.com/hoanghd218/tranvanhoang.com/tree/main/.claude/skills/markdown-novel-viewer
Command: npx skills add https://github.com/hoanghd218/tranvanhoang.com --skill markdown-novel-viewer-hoanghd218

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

View and browse Markdown content in a calm, distraction-free reading environment via a lightweight HTTP server, enabling long-form docs, reports, and notes to be read directly in the browser.

Core Features & Use Cases

  • Renders Markdown with a book-like theme and serif headings for comfortable reading.
  • Directory browsing with clean, clickable listings for quick navigation.
  • Mermaid diagrams support and syntax-highlighted code blocks for technical docs.
  • TOC generation and keyboard/theme navigation to improve accessibility and usability.

Quick Start

Start the server and open the provided URL to view your Markdown files.

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 browser over HTTP with syntax highlighting?

To view Markdown files over HTTP, this viewer converts Markdown to HTML using marked and highlight.js, rendering syntax-highlighted code blocks and a book-like theme directly in your web browser.

Can I render Mermaid diagrams and frontmatter when viewing Markdown over HTTP?

Yes, rendering Markdown over HTTP supports Mermaid diagram plug-ins and parses YAML frontmatter using gray-matter, ensuring both structured metadata and visual diagrams display correctly in the browser.

What is the best way to browse a directory of Markdown documents in a distraction-free reader?

Browsing a directory of Markdown documents is handled by a lightweight HTTP server that generates clean, clickable directory listings and a navigable table of contents for distraction-free reading.

Does this Markdown viewer support keyboard navigation and table of contents generation?

Yes, this Markdown viewer supports keyboard navigation and theme switching, while automatically generating a navigable table of contents from your Markdown files to improve accessibility and usability.

How do I start a local HTTP server to read my Markdown notes and long-form docs?

You can start the local HTTP server to read Markdown notes by running the provided script, then opening the generated URL in your browser to view long-form docs in a calm, book-like environment.