Generates self-contained, brow…

# Python爬虫教程Markdown转单文件HTML方案

一、推荐方案：mdBook 或 MkDocs

方案A：MkDocs + mkdocs-material（最推荐）

适合内网单文件分发需求，纯静态输出。

• 安装：pip install mkdocs mkdocs-material
• 初始化：mkdocs new my-docs，将教程Markdown放入 docs/ 目录
• 构建HTML：mkdocs build，产物在 site/ 目录
• 左侧目录导航由Material主题自动根据目录结构生成

方案B：pandoc + 自定义模板（真正的“单文件”）

```bash

pandoc tutorial.md -o tutorial.html \

--standalone --toc --toc-depth=3 \

--highlight-style=tango \

--metadata title="Python爬虫教程"

```

• --toc 自动生成目录，配合CSS设为左侧浮动定位
• 代码高亮内置支持，Python代码块用 ```python 标注即可

二、实现左侧目录导航的关键CSS

```css

/* 目录固定左侧 */

#TOC {

position: fixed;

left: 0; top: 0; width: 240px;

height: 100vh; overflow-y: auto;

border-right: 1px solid #ddd;

}

body { margin-left: 260px; }

/* 滚动时高亮当前章节需少量JS，可参考tocbot库 */

```

进阶可引入 tocbot.js（CDN引用或下载内嵌），实现滚动时自动高亮当前章节。

三、代码高亮方案对比

| 方案 | 特点 |

|------|------|

| Pandoc内置 | 无依赖，构建时高亮，适合内网离线 |

| highlight.js | 需引JS文件，可内嵌进HTML |

| Prism.js | 主题丰富，可inline嵌入 |

内网无外网环境建议：将highlight.js文件内容直接内嵌到HTML的 <script> 标签中，实现完全离线可用。

四、发送内网注意事项

• 确保生成的HTML无CDN外部依赖（字体、JS、CSS全部内联）
• 用浏览器离线打开验证：目录跳转、代码块渲染正常
• 单文件体积一般在几百KB到数MB区间，内网传输无压力
• 若教程含图片，需转为base64内嵌或与HTML打包成zip

五、最简操作路径

1. 确认Markdown中代码块已标注语言（```python）

2. 执行上述pandoc命令生成HTML

3. 手动补充左侧目录CSS（或用tocbot模板）

4. 离线测试后发布内网

如需，可进一步提供完整的pandoc模板文件供直接使用。