gendoc-gen-html

Convert Markdown and BDD feature files into a browsable HTML documentation site.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/ibalasite/gendoc --skill gendoc-gen-html
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gendoc-gen-html
Source: https://github.com/ibalasite/gendoc/tree/main/skills/gendoc-gen-html
Command: npx skills add https://github.com/ibalasite/gendoc --skill gendoc-gen-html

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It dynamically scans docs/.md and features/.feature and converts them into a professional HTML documentation site (docs/pages/), with Mermaid diagram rendering, a dark header, light content area, Chinese typography, Prism.js syntax highlighting, and responsive design.

Core Features & Use Cases

  • Markdown to HTML conversion: One-to-one mapping from Markdown and BDD feature files to HTML pages with navigation and responsive layout.
  • Mermaid diagram rendering: Inline diagrams render automatically within content for clear visual communication.
  • Mode options & automation: Supports full-generation (README + HTML) or HTML-only mode, callable standalone or via gendoc-auto, with a stateful session workflow for resume and control.

Quick Start

Use the gendoc-gen-html skill to generate the HTML docs website from docs/.md and features/.feature.

Frequently Asked Questions about gendoc-gen-html

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

FAQPage Schema
How do I convert Markdown files to an HTML documentation site with Mermaid diagrams?

To convert Markdown to an HTML documentation site, this tool scans docs/*.md and features/*.feature files, rendering Mermaid diagrams and syntax-highlighted code into a responsive, dark-themed HTML layout. It directly transforms repository-level docs into a browsable site.

Can I generate HTML documentation from BDD feature files?

Generating HTML documentation from BDD feature files is fully supported. The tool processes features/*.feature files alongside standard Markdown, mapping them one-to-one into browsable HTML pages with responsive layout and navigation.

Do I need Python to generate HTML documentation from Markdown?

Python is required to generate HTML documentation from Markdown. The generation process relies on Python for execution, while Mermaid and Prism.js handle diagram and code rendering within the output HTML pages.

Does Mermaid diagram rendering work automatically in the generated HTML docs?

Mermaid diagram rendering works automatically in the generated HTML docs. Inline Mermaid diagrams within your Markdown sources are rendered directly within the content area, providing clear visual communication without manual intervention.

What is the difference between full-generation and HTML-only mode for docs generation?

The difference between full-generation and HTML-only mode is scope: full-generation creates both README and HTML docs, while HTML-only mode generates just the HTML site. A stateful session workflow supports resume and control for both modes.

How do I customize Chinese typography in generated HTML documentation?

Customizing Chinese typography in generated HTML documentation is handled natively by the output template. The tool applies a responsive, dark-themed layout with light content areas that specifically supports Chinese typography alongside Prism.js syntax highlighting.