Documentation Viewer

A robust, modern documentation viewer built for rendering Markdown files with advanced syntax highlighting capabilities. This zero-dependency static application enables seamless documentation hosting without backend requirements.

Features

• 🚀 High-Performance Rendering - Lightning-fast Markdown processing with optimized syntax highlighting
• 📑 Dynamic Navigation - Auto-generated document outline with interactive table of contents
• 📱 Responsive Design - Optimized viewing experience across all device sizes
• 🔒 Zero Backend - Fully static implementation for maximum security and deployability
• 🎨 Modern UI/UX - Clean, intuitive interface with customizable theming

Quick Start

Development Setup

git clone https://github.com/litruv/Docs-Viewer
cd Docs-Viewer

adding better upstream method, uno momento

Deployment

Deploy anywhere that serves static files. For local development:

npx live-server

Project Structure

.
├── docs/           # Documentation source files
│   ├── images/     # Document assets
│   └── *.md        # Markdown documents
├── index.html      # Application entry point
├── config.json     # Document configuration
└── styles.css      # Theme customization

Configuration

Document Index

Configure your documentation structure in index.json:

{
    "documents": [
        {
            "title": "Getting Started",
            "path": "docs/getting-started.md"
        }
    ]
}

Folder Organization

Create hierarchical documentation structures with nested folders:

{
    "documents": [
        {
            "title": "Core Concepts",
            "type": "folder",
            "defaultOpen": true,
            "icon": "fa-solid fa-book",
            "path": "docs/core-concepts/index.md",
            "slug": "core-concepts",
            "items": [
                {
                    "title": "Architecture",
                    "path": "docs/core-concepts/architecture.md"
                }
            ]
        }
    ]
}

Folder Configuration Options

Option	Type	Description
type	string	Set to "folder" for directory nodes
title	string	Display name
path	string?	Optional content file path
slug	string	URL-friendly identifier (required with path)
items	array	Nested documents or folders
defaultOpen	boolean?	Auto-expand folder
icon	string?	Custom Font Awesome class

Technology Stack

Built with modern web technologies and carefully selected dependencies:

• marked - Markdown processing
• highlight.js - Syntax highlighting
• Font Awesome - UI iconography

License

Released under the MIT License. See LICENSE for details.

Contributing

Contributions are welcome! Please read our Contributing Guide for details.