md-render
Markdown Renderer
Render markdown files as beautiful dark-mode HTML and open them in the browser. Designed for viewing agent-generated documents (design docs, plans, reports).
Quick Reference
| Situation | Action |
|---|---|
| User asks to render/preview markdown | Run md-render <file> |
| User wants HTML output saved | Run md-render <file> -o output.html |
| User wants to customize styling | Edit ~/.config/agent-skills/md-render/config.json |
| User asks to pipe markdown | echo "# Title" | md-render - |
CLI Reference
| Command | Description |
|---|---|
md-render file.md |
Render and open in browser |
md-render - < file.md |
Render from stdin |
md-render file.md -o out.html |
Save HTML to file |
md-render file.md --no-open |
Generate HTML without opening browser |
md-render -c path.json file.md |
Use alternate config |
md-render --help |
Show usage |
Exit codes: 0 = success, 1 = error
Rendering Features
- Dark-mode aesthetic with configurable colors, fonts, and sizing
- Collapsible table of contents (inline and slide-out panel)
- Syntax-highlighted code blocks with copy-to-clipboard button
- Copy full markdown source button (top-right)
- Clickable heading anchors (hover to reveal)
- Mermaid diagram rendering (flowcharts, sequence diagrams, state diagrams, pie charts)
- Task list checkboxes, footnotes, ==highlights==, sub
script/super^script^ - Emoji shortcodes (:rocket: :white_check_mark:)
- Custom attributes via
{#id .class} - Responsive layout
- Self-contained HTML (mermaid uses CDN when enabled)
Configuration
Config location: ~/.config/agent-skills/md-render/config.json
Created automatically on first run from defaults. Edit to customize:
- theme — colors, fonts, sizing, max-width
- features — toggle toc, syntax highlighting, heading anchors, mermaid, browser open
More from hjewkes/agent-skills
self-improve
Use when a session produced reusable insights, when the user says "learn from this", "remember this", or "improve yourself", or after completing a complex task where patterns were discovered
63code-review
Unified code review system — dispatches the right review agents for the situation. Use when reviewing code for quality, bugs, compliance, or before merging.
17skills-management
Use when creating, finding, installing, reviewing, or managing Claude Code skills — covers skill authoring, discovery, conventions, and lifecycle management
14github-pr
GitHub PR workflow — creating PRs, posting automated review comments, managing PR feedback cycles. Use when code is reviewed and ready for GitHub.
14buildkite
Buildkite CI/CD integration. Use when the user needs to check build status, trigger builds, read build logs, debug failures, manage pipelines, or any Buildkite workflow. Triggers include "buildkite", "build", "pipeline", "CI", "deploy", "build log", "build failed".
14agent-browser
Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.
13