static-markdown-site

Convert a Markdown directory into a static website with a grouped sidebar.

2|2|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/huidge/hermes-skills --skill static-markdown-site
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: static-markdown-site
Source: https://github.com/huidge/hermes-skills/tree/main/software-development/static-markdown-site
Command: npx skills add https://github.com/huidge/hermes-skills --skill static-markdown-site

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill enables teams to turn a folder of Markdown files into a browsable static website, with a collapsible grouped sidebar and automatic syncing from source directories.

Core Features & Use Cases

  • Grouped, collapsible sidebar navigation for large collections of Markdown files.
  • Auto-sync from source directories into a static site build.
  • One-command deployment workflow to GitHub Pages via a docs/ folder.

Quick Start

Sync your Markdown sources, build the site, and deploy to GitHub with a single command.

Frequently Asked Questions about static-markdown-site

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

FAQPage Schema
How do I turn a directory of Markdown files into a static website?

To turn a Markdown directory into a static website, this Skill builds static HTML with a collapsible, grouped sidebar. It automatically syncs source folders and outputs a publish-ready site, making large documentation collections easily browsable.

What is the best way to organize a large collection of Markdown documentation?

Organizing Markdown documentation is best handled by generating a static site with a grouped, collapsible sidebar. This approach structures large collections of notes or reports into a navigable hierarchy, allowing users to expand and collapse sections for easier browsing.

How do I deploy a Markdown static site to GitHub Pages?

To deploy a Markdown static site to GitHub Pages, this Skill uses a one-command workflow that builds HTML into a docs directory. This process automatically syncs your source Markdown files and prepares them directly for GitHub Pages publishing.

Can I automatically sync Markdown files from source folders into a static site build?

Yes, you can automatically sync Markdown files from source folders into a static site build. This Skill performs automatic syncing from your source directories, ensuring the generated static HTML website reflects the latest Markdown updates without manual file copying.

Does this Markdown to HTML converter work for team documentation?

Yes, this Markdown to HTML converter works for team documentation. It is specifically designed for teams or individuals maintaining documentation, reports, or notes, providing a browsable, publish-ready static site with a grouped sidebar for collaborative knowledge bases.