markdown-novel-viewer

Render markdown files as novel-like reading experiences with diagrams.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/auxi-wardrobe/auxi-all-in --skill markdown-novel-viewer-auxi-wardrobe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-novel-viewer
Source: https://github.com/auxi-wardrobe/auxi-all-in/tree/main/.agents/skills/markdown-novel-viewer
Command: npx skills add https://github.com/auxi-wardrobe/auxi-all-in --skill markdown-novel-viewer-auxi-wardrobe

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a novel-like reading experience for markdown files, making it easier to consume long-form content.

Core Features & Use Cases

  • Calm Reading Experience: Reads markdown files with a warm, book-like theme, serif fonts, and minimal UI elements.
  • Mermaid.js Diagrams: Automatically renders Mermaid diagrams within markdown files, enhancing readability.
  • Directory Browsing: Allows browsing through directories, viewing markdown files and navigating subdirectories.
  • Navigation Tools: Provides a progress bar, auto-hide header, and keyboard shortcuts for a focused reading experience.
  • Mobile Optimization: Optimized for mobile devices with touch-friendly controls and a floating action button for navigation.
  • Use Case: Perfect for reading documentation, reports, novels, or any long-form markdown content on your device.

Quick Start

To view a markdown file, simply use the ck:preview command followed by the file path or directory, like this:

/ck:preview path/to/your/file.md

Frequently Asked Questions about markdown-novel-viewer

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

FAQPage Schema
How do I render markdown files into a readable HTML preview?

Yes, the markdown viewer renders Mermaid diagrams automatically within your markdown files. It uses mermaid.js alongside marked and highlight.js to process and display complex diagrams directly in the rendered HTML preview.

Can I browse markdown directories and navigate subdirectories?

The markdown viewer is optimized for mobile devices with touch-friendly controls and a floating action button for navigation. It provides a warm, book-like theme with serif fonts, minimal UI, and a progress bar for focused reading.

What is the best way to read long markdown documentation comfortably?

Yes, the markdown viewer includes navigation tools such as a reading progress bar, auto-hide header, and keyboard shortcuts. These features ensure a focused and seamless reading experience for long-form markdown content.

Does this markdown viewer support syntax highlighting for code blocks?

The markdown viewer uses gray-matter to parse frontmatter at the top of your markdown files. This allows the tool to process metadata headers correctly before rendering the main content into the HTML preview.