如何正确修改MkDocs中Markdown目录（Table of Contents）的标题？

哦，这个坑我之前刚踩过！你用的是Material主题的话，markdown toc扩展的title参数确实不会生效——因为Material主题的右侧侧边栏目录是主题自己生成和控制的，跟markdown原生的toc扩展不是一套逻辑，所以扩展里的配置根本影响不到它。

要修改右侧目录的标题，你得直接在MkDocs的主题配置里设置，具体步骤如下：

1. 打开你的mkdocs.yml配置文件
2. 找到theme配置块，在里面添加toc子配置项，设置title为你想要的自定义标题

举个完整的配置例子：

theme:
  name: material
  # 这里可以保留你原来的其他主题配置，比如palette、font等
  toc:
    title: "我的自定义目录" # 换成你想要的标题

markdown_extensions:
  - markdown.extensions.toc:
      baselevel: 1
      permalink: true
      # 这里的title参数可以留着，但它只影响你在页面里手动插入[TOC]标签生成的内嵌目录，不影响右侧侧边栏的目录

修改完之后，重启你的MkDocs服务（mkdocs serve），刷新页面就能看到右侧目录的标题变成你设置的内容了。

另外补充一句：如果你是想在页面内容里插入一个内嵌的目录（不是右侧侧边栏的），那markdown toc扩展的title参数才会生效，这时候你需要在页面里写[TOC]标签，生成的内嵌目录标题就会用你配置的SOMETITLE。

内容的提问来源于stack exchange，提问作者do-me