- Home
- Skills
- Technical Documentation
- Markdown Notes to HTML
Markdown Notes to HTML
Converts technical Markdown notes into self-contained HTML pages with validated inline SVG diagrams and MathML.
$1
Works with the AI Agents you already use
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
| Step | Status | Result |
|---|---|---|
| Plan | Success | Identified research/system-architecture.md |
| Render | Success | Integrated 1 SVG diagram and 2 MathML formulas |
| Validate | Pass | All checks (A-Q) passed successfully |
| Commit | Success | Manifest 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
- Run
python3 src/www.py navto update the site-wide sidebar. - Open
www/index.htmlin your browser to verify the iframe rendering. - Check the
STALEstatus of sibling pages that reference this note.
index.html
ZIP · project files
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
- Status Check: Run
www.py statusto identifyNEWorSTALEpages needing processing. - Planning: Invoke
www.py planfor a specific page ID to retrieve source paths and output destinations. - Generation: Populate the project HTML template with content, inline SVG diagrams, and MathML formulas.
- Validation: Execute
validate_page.pyto catch accessibility, sizing, and contract violations. - Finalization: Commit the update via
www.py commitand 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
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
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 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