mcpField
M
md-render

md-render

github.com/hjewkes文档处理468 次安装36 周前更新
代码仓库

关于 md-render

将 Markdown 文件渲染为深色模式 HTML 的命令行技能，也可在浏览器中打开结果。支持自定义样式、图表和代码高亮，并可生成独立 HTML，适合查看 Agent 生成的文档。

主要功能

  1. 01将 Markdown 渲染为 HTML
  2. 02在浏览器中打开渲染页面
  3. 03保存 HTML 或读取标准输入
  4. 04自定义颜色、字体与布局
  5. 05支持 Mermaid 图表和代码高亮
  6. 06响应式布局与交互式目录

适用场景

  1. 01预览计划与报告
  2. 02将 Markdown 保存为 HTML 文件
  3. 03查看含图表和代码的文档

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hjewkes/agent-skills --skill md-render

安装后在 Claude Code 中输入/md-render确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

package-lock.json
package.json
defaults/
config.json
scripts/
md-render
src/
render.mjs
templates/
page.html

详细介绍

Markdown 渲染器

将 Markdown 文件渲染为精美的深色模式 HTML，并在浏览器中打开。专为查看 Agent 生成的文档（设计文档、计划、报告）而设计。

快速参考

情况操作
用户要求渲染/预览 Markdown运行 md-render <file>
用户希望保存 HTML 输出运行 md-render <file> -o output.html
用户希望自定义样式编辑 ~/.config/agent-skills/md-render/config.json
用户要求通过管道传入 Markdownecho "# Title" | md-render -

CLI 参考

命令说明
md-render file.md渲染并在浏览器中打开
md-render - < file.md从 stdin 渲染
md-render file.md -o out.html将 HTML 保存到文件
md-render file.md --no-open生成 HTML，但不打开浏览器
md-render -c path.json file.md使用备用配置
md-render --help显示用法

退出代码： 0 = 成功，1 = 错误

渲染功能

  • 深色模式风格，可配置颜色、字体和大小
  • 可折叠目录（内嵌和滑出面板）
  • 带复制到剪贴板按钮的语法高亮代码块
  • 复制完整 Markdown 源码按钮（右上角）
  • 可点击的标题锚点（悬停时显示）
  • Mermaid 图表渲染（流程图、时序图、状态图、饼图）
  • 任务列表复选框、脚注、==高亮==、下标/上^标^
  • Emoji 简码（:rocket: :white_check_mark:）
  • 通过 {#id .class} 添加自定义属性
  • 响应式布局
  • 独立 HTML（启用时，mermaid 使用 CDN）

配置

配置位置：~/.config/agent-skills/md-render/config.json

首次运行时根据默认值自动创建。编辑该文件以自定义：

  • theme — 颜色、字体、大小、最大宽度
  • features — 切换 toc、语法高亮、标题锚点、mermaid 和浏览器打开功能

评论

支持 Markdown