嘿，这俩问题我之前也碰到过！用pandoc把MD转HTML时，目录和内部链接的生成其实有明确的玩法，我给你一步步捋清楚：

要让pandoc自动生成目录，得满足两个核心条件：

• 你的MD文件里必须用层级标题（#、##、###这种格式的标题），pandoc是基于这些标题来生成目录结构的。
• 转换命令里必须加上--toc参数，还可以用--toc-depth=N指定目录要显示到哪一层（比如--toc-depth=3就是显示到###级别的标题）。

给你个完整的命令示例：

pandoc your-document.md -o output.html --toc --toc-depth=3

运行这个命令后，生成的HTML顶部会自动出现带跳转功能的目录，点击目录里的标题就能直接跳到对应的章节。

内部链接不好使，大概率是MD里的锚点格式没匹配pandoc的规则，这里有两种靠谱的解决方法：

方法1：匹配pandoc自动生成的锚点 #

pandoc会自动把标题转换成「小写+空格替换为连字符」的锚点格式，比如：

• MD里的标题是## 安装Pandoc的详细步骤，生成的HTML锚点就是#安装-pandoc-的-详细步骤
• 对应的内部链接就得写成[跳转到安装步骤](#安装-pandoc-的-详细步骤)

不过这种方式如果标题里有特殊字符（比如中文标点、emoji），容易出问题，更稳妥的是下面这种方法。

方法2：手动给标题指定ID #

在MD的标题后面加{#自定义ID}，强制指定锚点，比如：

## 安装步骤 {#install-step}

然后内部链接直接写[跳转到安装步骤](#install-step)就行，不管标题怎么改，这个链接都能正常跳转。

给你个完整的MD示例参考：

# 我的教程文档 {#main-doc}

## 快速导航
- [安装指南](#install-guide)
- [使用技巧](#usage-tips)

## 安装指南 {#install-guide}
这里写安装的具体步骤...

## 使用技巧 {#usage-tips}
这里写实用的使用技巧...

用之前的转换命令处理后，这些内部链接就能完美跳转了。

• 别用--no-section-divs这类参数，它会禁用pandoc的章节锚点功能，直接导致内部链接失效。
• 如果你的MD文件里有大量中文标题，优先用手动指定ID的方式，避免自动生成的锚点出现编码问题。

内容的提问来源于stack exchange，提问作者prajna