serve-md-by-mkdocs

What problem does it solve?

This Skill provides a quick, web-based viewer for Markdown scattered across a repository by serving them with MkDocs while preserving the original directory structure.

Core Features & Use Cases

• Web-based Markdown viewer: browse notes, runbooks, and docs across a project without moving files.
• Dedicated work directory scaffolding: auto-create a scanner, manifest, and a generated mkdocs.yml (preserving existing config when available).
• Built-in MkDocs integration: Mermaid and KaTeX support via pymdown-extensions, with a simple path for serving locally.
• Use Case: quickly preview scattered documentation in a large codebase without reorganizing assets or writing custom docs nav.

Quick Start

Run the workflow to scaffold the docview service and start MkDocs serve:

• Create or reuse a work directory and run the refresh-docs-tree.sh to build the staged tree.
• Start MkDocs: mkdocs serve -f <work_dir>/mkdocs.yml