What problem does it solve? MariaDB documentation pages often contain plain-Markdown substitutes, broken GitBook blocks, or raw cross-space URLs that render incorrectly in GitBook. This Skill converts prose notes, parallel content, and code samples into correct GitBook-flavored Markdown and fixes unbalanced blocks without touching code examples. ## Core Features & Use Cases - Callouts and Tabs: Converts prose notes into {% hint %} blocks with the four valid styles (info, warning, danger, success) and turns platform-parallel content into {% tabs %} structures. - Code Blocks, Content-Refs, and Includes: Wraps fenced code in titled {% code %} blocks when useful, builds {% content-ref %} page cards, and manages reusable or file-based {% include %} directives with correct relative path depth. - Link Conversion and Block Repair: Converts raw GitBook URLs into cross-space {alias} links, fixes invalid hint styles, and repairs unbalanced block openers and closers. - Use Case: A contributor asks to "make this a warning box and convert these links to aliases" on a server docs page; the Skill rewrites the admonition as {% hint style="warning" %}, swaps hard-coded URLs for {maxscale}-style aliases, and leaves all SQL code samples untouched. ## Quick Start Ask the AI to fix the GitBook formatting on a specific MariaDB docs page, converting notes into hint blocks and raw URLs into alias links.
