Markdown 网页排版助手

Markdown 网页排版助手

这个 Skill 能做什么

把 Markdown 转成适合网页或内容平台粘贴的样式化 HTML，并处理代码、公式、图表、脚注和引用。

完成任务时重点处理：

• Markdown 语义到 HTML 的准确转换
• 目标渠道兼容与样式隔离
• 代码、公式、图表和外链引用处理

最终目标不是堆出一份看似完整的内容，而是交付能够直接使用、继续修改并清楚验收的结果。

什么时候使用

• 已有 Markdown 正文，需要生成稳定、可预览且兼容目标渠道的 HTML。
• 用户需要把 Markdown 转成适合网页或内容平台粘贴的样式化 HTML，并处理代码、公式、图表、脚注和引用。
• 任务需要同时控制Markdown 语义到 HTML 的准确转换、目标渠道兼容与样式隔离。

如果目标平台不支持复杂元素时使用图片或纯文本降级并明确差异，先处理前置条件，不要直接假装任务已经完成。

开始前需要什么

优先收集：

1. 目标、输入文件与预期输出
2. 运行环境、依赖、版本和目录约束
3. 已有代码、接口、样例和错误信息
4. 安全、性能、兼容性和测试要求
5. 目标平台允许的 HTML 与 CSS 范围
6. 代码高亮、公式、图表和引用的处理偏好

信息不必一次问完。先检查用户已经提供的材料，只追问会明显改变结果的问题。

执行步骤

1. 检查 Markdown

修复标题、列表、代码围栏、表格和链接语法。

2. 选择兼容策略

确定内联样式、类名、图片化图表和外链处理方式。

3. 转换基础内容

生成语义正确的标题、段落、列表、表格和引用。

4. 处理扩展内容

转换代码、公式、流程图、脚注和提示块。

5. 清理与隔离

删除不允许标签，防止样式污染目标页面。

6. 真实预览

在目标渠道或等价容器中检查宽度、字体和复制粘贴结果。

输出格式

至少交付以下内容：

• HTML 成品：适合目标渠道使用的完整或片段 HTML
• 预览文件：可在浏览器打开的审阅版本
• 兼容说明：被转换、降级或需要手动处理的元素

所有文件使用能说明内容和版本的名称。若任务包含执行动作，还要记录执行状态、验证结果和可继续处理的材料。

完整示例

用户要把含代码、公式和流程图的教程发布到内容平台；将不兼容图表渲染为图片，并把外链整理到文末。

合理处理顺序：

1. 检查 Markdown
2. 选择兼容策略
3. 转换基础内容
4. 处理扩展内容
5. 清理与隔离
6. 真实预览

交付时应重点展示HTML 成品、预览文件、兼容说明，并说明尚未验证的部分。

质量检查清单

• [ ] 命令、脚本和依赖在目标环境可运行
• [ ] 输入、输出、错误和边界情况均被处理
• [ ] 关键步骤可重复执行且不会意外覆盖原件
• [ ] 完成最小测试并记录验证命令与结果
• [ ] 危险标签和事件属性已清理
• [ ] 复制到目标编辑器后标题、图片和代码仍保持正确

信息不足时怎么处理

• 缺少依赖或权限时先给出可验证的替代路径。
• 环境未知时避免绑定单一工具，明确适配点。
• 目标平台不支持复杂元素时使用图片或纯文本降级并明确差异。