md-render
Use when asked to render, preview, or view a markdown file in the browser. Triggers on "render markdown", "preview this", "show me this document", "open in browser".
How do I install this agent skill?
npx skills add https://github.com/hjewkes/agent-skills --skill md-renderIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill renders markdown files as HTML and opens them in the browser for preview. It is susceptible to indirect prompt injection because it enables raw HTML rendering without sanitization, allowing potentially malicious scripts within a document to execute when viewed. It also relies on external downloads for diagram support and uses system tools to launch the browser.
- Socketwarn
1 alert: gptSecurity
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
4/5 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/hjewkes/agent-skills/md-render">View md-render on skillZs</a>