← 返回 Skills 市场
seanxu98

md-to-html

作者 SeanXu98 · GitHub ↗ · v1.0.6 · MIT-0
cross-platform ⚠ suspicious
241
总下载
1
收藏
0
当前安装
7
版本数
在 OpenClaw 中安装
/install md-to-html
功能描述
将Markdown格式的笔记转换为带左侧固定目录大纲的可阅读HTML文件。适用于:(1) 将学习笔记、技术文档转换为可浏览的HTML;(2) 为Markdown文件生成带目录导航的阅读界面;(3) 整理长文档生成静态网站。触发条件:用户说转换HTML、markdown转html、生成HTML笔记、把笔记转成网页等
安全使用建议
This skill looks coherent at a high level: the bundled JS/CSS libraries match the described features and Python is the only required binary. The main risk is that the agent will run scripts/md2html.py — the scanner output omitted the full script, so you must inspect scripts/md2html.py before installing or executing. Specifically: (1) Open and review scripts/md2html.py for network calls (requests, urllib, sockets), subprocess.exec/spawn usage, or code that reads paths outside the supplied input file. (2) Search all files (including SKILL.md) for invisible Unicode control characters or suspicious string-handling that might attempt injection. (3) Run the script locally on a non-sensitive test Markdown file in a sandbox or container (no network) to observe behavior and any outbound connections. (4) If you are not comfortable reading the Python file, decline installation or run it in an isolated VM. If you share the contents of scripts/md2html.py I can do a more specific code-level review and update the verdict.
功能分析
Type: OpenClaw Skill Name: md-to-html Version: 1.0.6 The skill bundle provides a legitimate utility for converting Markdown files to HTML with a table of contents and syntax highlighting. The Python script (scripts/md2html.py) uses the standard 'markdown' library and embeds local CSS/JS resources from the lib/ directory. No network activity, unauthorized file access, or obfuscated code was detected. The behavior is entirely consistent with the documentation in SKILL.md.
能力评估
Purpose & Capability
Name/description (Markdown → HTML with sidebar, syntax highlighting, KaTeX, Mermaid) align with the included static assets (Prism, KaTeX, Mermaid) and the declared runtime requirement (python). Requiring only the python binary is proportionate.
Instruction Scope
Runtime instructions tell the agent to run python scripts/md2html.py -i <file>. The conversion is plausible, but the actual behavior depends entirely on scripts/md2html.py. The scanner output shown to me did not include the script's full source (some files were truncated/omitted), so I cannot confirm the script's scope — it could be harmless or it could read other files, access the network, or invoke subprocesses. The SKILL.md itself does not constrain the script's actions or require only the input file to be read.
Install Mechanism
No network installs or external downloads are declared (no install spec). Libraries are bundled in lib/, which is consistent with the 'completely offline' claim. Bundled assets are large but expected for KaTeX/Mermaid/Prism.
Credentials
The skill declares no environment variables, credentials, or config paths. That is appropriate for a local Markdown→HTML converter.
Persistence & Privilege
Skill is not always-enabled and does not request elevated or persistent privileges. Autonomous invocation is allowed but is the platform default; nothing in the metadata requests system-wide changes.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install md-to-html
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /md-to-html 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.6
-修复潜在安全风险
v1.0.5
- 内置所有前端依赖(KaTeX, Prism.js, Mermaid 等)到 lib/ 目录,实现完全离线渲染 - 新增对多种代码语法高亮(Python, Bash, JavaScript, JSON),并内附相关主题和脚本 - 支持LaTeX公式和Mermaid图表,无需首次运行时动态下载 - 主脚本改为 scripts/md2html.py,原 md_to_html.py 移除 - 更新技能文档,说明所有库为离线内嵌,强化对目录、交互体验和渲染特性的说明
v1.0.4
v1.0.4 变更日志 - 重构脚本,移除旧的 scripts/md2html.py,新增 md_to_html.py - 修复 LaTeX 公式和 Mermaid 图表渲染异常的问题 - 改为自动下载并内嵌 JS 库,生成的 HTML 文件可离线使用 - 规范化输出目录导航栏,提升交互体验
v1.0.3
- 增加全面安全特性说明,包括内容过滤、CSP策略、路径防护等。 - 新增命令行参数:--mathjax、--prism、--mermaid、--all-features,实现各扩展能力按需启用。 - 默认情况下,HTML输出不加载外部资源,用户需显式选择启用扩展。 - 更新用法说明、示例、参数表和功能分区,强调安全与扩展特性。 - 添加安全加固相关更新日志。
v1.0.2
- Command examples in SKILL.md updated to use placeholder paths (`<python路径>` and `<skill路径>`) for better portability. - Added a usage note explicitly mapping placeholders to actual paths in the current environment. - No changes to code or functionality.
v1.0.1
Version 1.0.1 - 新增目录层级控制参数(-l, --level),可选目录最大标题层级 - 输出HTML功能增强:支持交互式目录(折叠/展开、拖拽宽度、滚动高亮) - 增加对数学公式(MathJax)和Mermaid图表的支持 - 代码高亮方式从Pygments变更为Prism.js - 更新文档示例路径与依赖说明 - 新增.clawhub/origin.json与_meta.json元数据文件
v1.0.0
- 首次发布:md-to-html v1.0.0 上线。 - 支持将Markdown笔记转换为含左侧固定目录和代码高亮的可阅读HTML文件。 - 支持自定义输出路径、页面标题和样式主题(default/dark)。 - 生成HTML自动构建章节目录,支持目录跳转和返回顶部按钮。 - 输出为响应式设计,适配不同屏幕。 - 依赖 Python 3.13、markdown、pygments(OpenClaw环境已集成)。
元数据
Slug md-to-html
版本 1.0.6
许可证 MIT-0
累计安装 1
当前安装数 0
历史版本数 7
常见问题

md-to-html 是什么?

将Markdown格式的笔记转换为带左侧固定目录大纲的可阅读HTML文件。适用于:(1) 将学习笔记、技术文档转换为可浏览的HTML;(2) 为Markdown文件生成带目录导航的阅读界面;(3) 整理长文档生成静态网站。触发条件:用户说转换HTML、markdown转html、生成HTML笔记、把笔记转成网页等. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 241 次。

如何安装 md-to-html?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install md-to-html」即可一键安装,无需额外配置。

md-to-html 是免费的吗?

是的,md-to-html 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

md-to-html 支持哪些平台?

md-to-html 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 md-to-html?

由 SeanXu98(@seanxu98)开发并维护,当前版本 v1.0.6。

💬 留言讨论