Markdown Notes to HTML

    1

    Converts technical Markdown notes into self-contained HTML pages with validated inline SVG diagrams and MathML.

    $1

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Markdown Notes to HTML

    Example session with this skill installed

    Generate the HTML page for the system-architecture note in the research section. Use the standard template and include a diagram for the data flow.

    • Read your context and instructions
    • Compiled the markdown notes to
    • Generated the app files

    I have processed the research/system-architecture page. I ran www.py plan to get the sources, generated the HTML with a responsive data-flow SVG, and verified it against the 16-point validation suite.

    Page Generation Summary

    StepStatusResult
    PlanSuccessIdentified research/system-architecture.md
    RenderSuccessIntegrated 1 SVG diagram and 2 MathML formulas
    ValidatePassAll checks (A-Q) passed successfully
    CommitSuccessManifest updated with new hash
    <!-- Final output written to www/pages/research/system-architecture.html -->
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>System Architecture</title>
        <!-- CSS and JS from assets/page-template.html -->
    </head>
    <body>
        <main>
            <h1>System Architecture</h1>
            <section>
                <h2>Data Ingestion Flow</h2>
                <div class="fig-frame">
                    <svg viewBox="0 0 740 200" style="--fig-vb:740px" aria-label="Data flow diagram">
                        <!-- Inline SVG content -->
                        <rect x="10" y="10" width="100" height="40" class="node" />
                        <text x="60" y="35" text-anchor="middle">Source</text>
                        <path d="M 110 30 L 200 30" class="edge" />
                    </svg>
                    <div class="legend">Arrows indicate data direction</div>
                </div>
            </section>
            <footer class="sources">
                <ul id="source-list">
                    <li data-role="main">research/system-architecture.md</li>
                </ul>
            </footer>
        </main>
    </body>
    </html>
    

    Next steps

    1. Run python3 src/www.py nav to update the site-wide sidebar.
    2. Open www/index.html in your browser to verify the iframe rendering.
    3. Check the STALE status of sibling pages that reference this note.

    index.html

    ZIP · project files

    Generated

    Example file from a real run - the skill writes it into your workspace.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Technical documentation often rots because the bridge between raw Markdown notes and a navigable web portal is manual and error-prone. This skill automates the translation of Markdown mirrors into self-contained, high-fidelity HTML pages for the NotesHub ecosystem. It handles the heavy lifting of visual presentation while strictly adhering to your existing repository structure and manifest state.

    What it does

    • Note Translation converts Markdown files into structured HTML pages using standardized templates.
    • Diagram Generation renders hand-written inline SVGs for flowcharts, state machines, and architecture maps.
    • Data Visualization processes JSON specs into accessible charts with dual variants for responsive design.
    • Validation runs a suite of 16 automated checks to ensure offline self-sufficiency and CSS specificity.
    • Lifecycle Management interacts with repo scripts to plan, validate, and commit page updates to the manifest.

    How it works

    1. Status Check: Run www.py status to identify NEW or STALE pages needing processing.
    2. Planning: Invoke www.py plan for a specific page ID to retrieve source paths and output destinations.
    3. Generation: Populate the project HTML template with content, inline SVG diagrams, and MathML formulas.
    4. Validation: Execute validate_page.py to catch accessibility, sizing, and contract violations.
    5. Finalization: Commit the update via www.py commit and regenerate the global navigation menu.

    Frameworks & tools

    Built for Python 3 environments using standard library modules. Relies on MathML for formulas and inline SVG for diagrams to maintain zero-dependency, offline-first portability.

    Why this beats prompting it yourself

    Generic prompts often hallucinate headings or include external CDN links that break offline viewing. This skill enforces strict heading parity with source files and automatically manages complex responsive SVG logic that standard LLM outputs typically fail.

    Use cases

    • Generating technical architecture pages with embedded, non-scaling SVG flowcharts.
    • Converting research notes containing complex math into portable MathML-based HTML.
    • Updating documentation portals where manual manifest and hash management is too slow.

    Known limitations

    Requires a specific repository structure including src/www.py and www/. Does not support Mermaid.js or KaTeX due to offline-use constraints.

    [Note] This skill serves as the core AI component of the open-source project NotesHub. For the complete automated Markdown synchronization and management workflow, please visit my GitHub repository for the full project: https://github.com/Suricatalu/NotesHub

    Requires local Python 3 and NotesHub repo structure. No support for external JS libraries (Mermaid/KaTeX). Will not overwrite manually edited DIRTY files without confirmation.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Money-back guarantee

    Doesn't do what its page promises? You get your money back.

    Trust & safety

    Security scan

    Security scan passed 24 days ago

    Permissions

    Terminal / Shell
    Network Access
    Read Files
    Write Files
    Listed24 days ago

    What's inside

    Frequently Asked Questions

    This skill eliminates "documentation rot" by automating the conversion of Markdown notes into high-fidelity HTML, ensuring that complex SVG diagrams and MathML formulas remain valid, responsive, and perfectly synced with your repository manifest.

    The skill is designed for Python 3 environments and requires a repository structure that includes a `src/www.py` controller and a `www/` output directory to manage page states and manifests.

    To prioritize offline portability and zero-dependency viewing, this skill uses native inline SVGs and MathML instead of external libraries like Mermaid.js or KaTeX, which often require CDN links that can break in offline environments.

    Yes, the skill includes a validation suite that runs 16 automated checks, ensuring every generated page meets accessibility standards, CSS specificity requirements, and contract violations before you commit changes.

    You receive the core logic for note translation, the diagram generation engine, the 16-point validation suite, and the lifecycle management scripts (plan, validate, commit) for integration into your workflow.

    New in Technical Documentation