knoopx/markdown-rendering
agent/skills/knowledge/markdown-rendering/SKILL.md
Renders markdown to self-contained HTML with a custom dark stylesheet and opens in browser. Use when previewing markdown documents, generating styled HTML from README or report files.
$ install --global
skillsauthnpx skillsauth add knoopx/pi markdown-renderingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 20, 2026, 7:58 AM396.5s1 file scanned
SKILL.md
- name:
- markdown-rendering
- description:
- Renders markdown to self-contained HTML with a custom dark stylesheet and opens in browser. Use when previewing markdown documents, generating styled HTML from README or report files.
- related:
- [bash]
Markdown Rendering
Convert any markdown file to a styled, self-contained HTML document and open it in the default browser.
Quick render (existing file)
nix run nixpkgs#pandoc -- \
--from=markdown-implicit_figures --to=html --embed-resources --standalone \
--css="$HOME/.pi/agent/skills/knowledge/markdown-rendering/assets/style.css" \
input.md -o output.html && xdg-open output.html
Quick render (piped stdin — no temp file)
Pandoc accepts - as the input filename to read from stdin. Use this when generating markdown on the fly:
echo '# Hello World' | nix run nixpkgs#pandoc -- \
--from=markdown-implicit_figures --to=html --embed-resources --standalone \
--css="$HOME/.pi/agent/skills/knowledge/markdown-rendering/assets/style.css" \
- -o output.html && xdg-open output.html
Stylesheet
The stylesheet lives at assets/style.css and is derived from ~/.nix/modules/nixos/defaults/colors.nix (base16 palette). It provides:
- Dark background (
#191033) with light text (#f8f8f8) - Yellow accents on headings (
#fad000) - Cyan links (
#80fcff) and green code strings (#a5ff90) - Styled tables, blockquotes, code blocks, and horizontal rules
Constraints
- Always use
nix run nixpkgs#pandoc— do not assume pandoc is on PATH - Always pass
--embed-resources --standaloneso the HTML is fully portable (no external CSS/JS dependencies) - Always pass
--css=<path>pointing toassets/style.cssfor consistent styling - Always open with
xdg-openafter rendering — the user expects to see the result - Pipe generated markdown via stdin (
-) instead of writing a temp file — pandoc reads stdin natively
Related Skills
knoopx/notify
tools
VerifiedTrustedCommunity
Inform the user what is happening — skip passive lookups
52SKILL.mdUpdated May 20, 2026
knoopx/jj-hunk
testing
VerifiedTrustedCommunity
Programmatic hunk selection for Jujutsu — split, commit, or squash specific hunks without interactive prompts. Use when making partial commits or selective squashes.
52SKILL.mdUpdated May 18, 2026
knoopx/jj-core
content-media
VerifiedTrustedCommunity
Manage version control with Jujutsu (jj) — no staging area, immediate changes, smart rebasing. Use when navigating history, squashing, or pushing to Git remotes.
52SKILL.mdUpdated May 18, 2026
knoopx/research-protocol
development
VerifiedTrustedCommunity
Gather facts from the web using evidence-first approach with mandatory citations. Use when researching topics, answering factual questions, or any task requiring web-sourced evidence.
52SKILL.mdUpdated May 18, 2026