Why should I use GitHub Actions instead of mkdocs gh-deploy?

GitHub Actions is the modern recommended method; it offers better security via OIDC, clearer environment tracking, and removes the need for local write access to the gh-pages branch.

Can I use this for documents that contain LaTeX commands?

Yes, the skill includes logic to remove PDF-specific commands like \pagebreak that cause visual artifacts when rendering to HTML.

Does this skill help with grid tables?

Yes, it provides the specific extension configuration and installation steps needed to render Pandoc-style grid tables in MkDocs.

How does this skill handle broken list rendering?

It identifies and fixes 4-space indentation and unsupported list markers (like roman numerals) that Python-Markdown incorrectly interprets as code blocks.

MkDocs GitHub Pages Deployment & Fixer

Name: MkDocs GitHub Pages Deployment & Fixer
Author: SecurityRonin

bySecurityRonin

0•

Deployment & DevOps

Automates MkDocs deployments to GitHub Pages using modern GitHub Actions while fixing common Python-Markdown rendering issues.

This skill provides a comprehensive framework for deploying MkDocs documentation to GitHub Pages using secure, modern GitHub Actions workflows. Beyond simple deployment, it addresses 'hard-won' knowledge regarding Python-Markdown rendering pitfalls, such as indentation errors that turn lists into code blocks, truncated footnotes, and broken grid tables. It is particularly useful for teams maintaining complex policy or technical documentation who need to ensure their web output is clean, professional, and free of LaTeX artifacts or formatting bugs.

Key Features

01Automated fixes for Python-Markdown list indentation and marker issues

02Grid table support configuration for Pandoc-style documentation

03Footnote formatting logic to ensure multi-line content renders correctly

04LaTeX command removal to eliminate visual artifacts in HTML output

05Modern GitHub Actions workflow templates using OIDC and environment tracking

060 GitHub stars

Use Cases

01Migrating legacy MkDocs deployment scripts to secure GitHub Actions 'Pages' source

02Ensuring complex policy documents with footnotes and grid tables render perfectly

03Standardizing documentation formatting across large repositories with nested lists

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add securityronin/ronin-marketplace mkdocs-github-pages-deployment

For use in Claude.ai and ChatGPT

Download Skill