用途:把任意 Markdown 文件转换为带样式的、自包含的 HTML 文档,并在默认浏览器中打开,适合预览 Markdown 文档或生成可直接分发的样式化 HTML。
主要能力:基于 pandoc 渲染,使用 --embed-resources --standalone 生成不依赖外部 CSS/JS 的可移植 HTML;配套样式表位于 assets/style.css,源自 base16 调色板,提供深色背景(#191033)与浅色文字(#f8f8f8)、标题黄色强调(#fad000)、青色链接(#80fcff)、绿色代码字符串(#a5ff90),并美化表格、引用块、代码块与分隔线。
使用方式:渲染已有文件时执行 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。若 Markdown 由管道生成,可用 - 作为输入文件名从 stdin 读取,例如 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。
约束:始终使用 nix run nixpkgs#pandoc,不要假设 pandoc 已在 PATH 中;始终传入 --embed-resources --standalone 以保证 HTML 完全可移植;始终通过 --css=<path> 指向 assets/style.css 以保持样式一致;渲染后始终用 xdg-open 打开;生成 Markdown 时优先通过 stdin(-)传入而非写临时文件。
适用场景:预览 Markdown 文档、生成带样式的独立 HTML。限制:依赖 Nix 与 pandoc,样式表路径固定,其他平台或环境细节暂未提供。