skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
hjewkes/agent-skills68 installs

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-render
view source ↗

Is 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

SituationAction
User asks to render/preview markdownRun md-render <file>
User wants HTML output savedRun md-render <file> -o output.html
User wants to customize stylingEdit ~/.config/agent-skills/md-render/config.json
User asks to pipe markdownecho "# Title" | md-render -

CLI Reference

CommandDescription
md-render file.mdRender and open in browser
md-render - < file.mdRender from stdin
md-render file.md -o out.htmlSave HTML to file
md-render file.md --no-openGenerate HTML without opening browser
md-render -c path.json file.mdUse alternate config
md-render --helpShow 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==, subscript/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

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>