核心用法
markdown-convert 是一款纯本地运行的文档格式转换技能，基于 Python 实现 Markdown、HTML、PDF 三者之间的双向转换。用户可通过命令行直接调用，支持从本地文件读取或传入原始内容两种输入方式。
主要功能模块：
- Markdown → HTML：生成带基础样式的完整独立 HTML 页面，可选自定义标题
- Markdown → PDF：将 Markdown 转换为 PDF 并以 base64 编码返回，便于下载保存或直接下发
- HTML → Markdown：将网页内容或 HTML 片段反向转为可编辑的 Markdown 格式
典型使用场景：
- 技术文档整理与分享：将笔记导出为精美的 HTML 页面或 PDF 报告
- 数据采集后处理：配合极速数据等 API 拉取结构化数据，再转换为易读的 Markdown/HTML 报告
- 内容迁移：抓取网页 HTML 后转为 Markdown 进行二次编辑
显著优点：
- 零 API 成本：完全本地运行，无外部服务依赖，无 Token 消耗
- 输出即开即用：HTML 包含完整样式可直接预览，PDF 支持 base64 解码保存
- 灵活输入：支持文件路径与原始内容两种模式，适配对话交互场景
- 轻量依赖：仅需 3 个 Python 库（markdown、xhtml2pdf、html2text）
潜在局限：
- PDF 渲染基于 xhtml2pdf，对复杂 CSS 支持有限，可能出现排版偏差
- HTML 样式为基础内置样式，重度自定义需手动修改源码
- 无实时协作或云端同步能力
- 输入内容需自行确保安全性，技能本身不做 XSS 过滤
适合人群：
开发者、技术写作者、数据分析师、需要快速生成可分享文档的知识工作者
常规风险：
- 处理用户上传文件时需注意路径遍历风险（虽技能内部未显式防护）
- PDF/HTML 输出内容若包含恶意脚本，可能在下游消费时触发安全问题
- 依赖的第三方库（尤其是 xhtml2pdf）需关注安全更新