md-to-html
# Markdown转HTML工具
将Markdown笔记转换为带有左侧固定目录大纲的可阅读HTML页面。
## 使用方法
### 基本命令
```bash
python scripts/md2html.py -i <markdown文件路径>
```
> **提示**：Agent 会自动使用正确的 Python 路径执行脚本。
### 参数说明
| 参数 | 说明 |
|------|------|
| `-i, --input` | 输入的Markdown文件路径（必需） |
| `-o, --output` | 输出的HTML文件路径（可选，默认与输入同目录） |
| `-t, --title` | HTML页面标题（可选，默认使用文件名） |
| `-l, --level` | 目录中显示的最大标题层级（1-6，默认4） |
### 示例
```bash
# 基本转换
python scripts/md2html.py -i "AI学习笔记.md"
# 指定输出路径
python scripts/md2html.py -i notes.md -o output.html
# 指定标题和目录层级
python scripts/md2html.py -i notes.md -t "我的学习笔记" -l 3
```
## 输出特点
生成的HTML包含：
- **左侧固定目录**：自动从标题生成，支持折叠/展开
- **目录交互**：点击跳转、滚动高亮、可拖拽调整宽度
- **代码高亮**：Prism.js 支持 Python、Bash、JavaScript、JSON
- **数学公式**：KaTeX 支持 LaTeX 语法（完全离线，字体内嵌）
- **Mermaid图表**：支持 flowchart、sequenceDiagram、graph 等图表
- **响应式设计**：适配移动端，自动隐藏侧边栏
- **返回顶部**：滚动后显示返回顶部按钮
- **完全离线**：所有 JS/CSS/字体已内嵌，无需网络连接
## 支持的Markdown特性
- 标题（H1-H6）
- 段落、粗体、斜体
- 有序/无序列表
- 代码块（带语法高亮）
- 表格
- 引用块
- 图片
- 超链接
- 数学公式（LaTeX）
- Mermaid 图表
## 目录结构
```
md-to-html/
├── SKILL.md # 技能说明文档
├── scripts/
│ └── md2html.py # 转换脚本
└── lib/ # 内嵌的 JS/CSS 库
├── prism-tomorrow.min.css # Prism 主题
├── prism.min.js # Prism 核心
├── prism-python.min.js # Python 语法
├── prism-bash.min.js # Bash 语法
├── prism-javascript.min.js # JavaScript 语法
├── prism-json.min.js # JSON 语法
├── mermaid.min.js # Mermaid 图表
├── katex.min.js # KaTeX 核心
├── katex.embedded.css # KaTeX 样式（含内嵌字体）
└── auto-render.min.js # KaTeX 自动渲染
```
## 依赖
- Python 3.x
- markdown (Python库)
所有前端库已打包到 `lib/` 目录，无需网络即可使用。
标签
skill
ai
