Agent Skills
返回列表
Markdown 转 HTML

Markdown 转 HTML

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_15292d5a/yjkj-cn-markdown-to-html。

技能介绍

要解决什么问题

在脚本、静态页或简单发布流程里，你往往只需要把一份 .md 读进来，得到带基本排版的完整 HTML，而不是再挂一套重量级解析库或前端构建链。本技能面向轻量、可嵌入的转换场景：输入 Markdown 文本或文件，输出可直接保存或内嵌的 HTML 文档。

如何工作

转换逻辑围绕常见写作元素展开，与 SKILL 中列出的能力一致：

  • 标题：# / ## / ### 映射为 H1～H3
  • 强调：**粗体**、*斜体*
  • 链接：标准 Markdown 链接语法
  • 代码：行内 ` code ` 与代码块
  • 文档壳：生成完整 HTML 文档（含文档结构），而非零散片段

实现侧强调 纯 Python、无外部依赖，适合在受限环境、CI 或一次性工具里直接调用，不引入额外包管理负担。

适用边界

这是面向常见语法的转换器，不是 CommonMark / GFM 全特性实现。复杂表格、任务列表、脚注、数学公式等若未在技能说明中列出，应假定不支持或需自行验证。若你需要与 GitHub 渲染 1:1 对齐，应选用完整规范实现；若目标是「readme 级」标题、段落、链接与代码的 HTML 落地，本技能更贴合。

使用场景

  • 用 Python 脚本读取仓库里的 `readme.md`，生成带 H1～H3、链接与代码块的完整 HTML，供内网静态页直接打开。
  • CI 发布前把版本说明 Markdown 转成独立 HTML 文件，归档到制品库或邮件附件，无需前端构建。
  • 目标机器不能随意 `pip install` 解析库时，在一次性工具里把技术笔记 `.md` 批量导出为完整 HTML 文档。
  • 本地文档流水线只需标题、粗斜体、行内与块级代码时，把说明 Markdown 落成可嵌入的 HTML 页面。

适合人员

  • 维护项目 README 与变更说明、需要把 Markdown 落成可单独浏览 HTML 的开源或内部库维护者
  • 在受限环境写 Python 小工具、希望零第三方依赖完成 md→HTML 的后端或平台工程师
  • 管理内网知识库、要把既有 `.md` 按标题与代码格式转成完整 HTML 再挂载的文档管理员
  • 编写构建或发布自动化、需在流水线里生成 HTML 版 release notes 的 DevOps 工程师