如果你的Markdown文件要在bitbucket.org上的回购中显示，你应该在你想要你的目录的位置添加[TOC]。然后它将自动生成。更多信息:

https://confluence.atlassian.com/bitbucket/add-a-table-of-contents-to-a-wiki-221451163.html

在Gitlab上，marklab支持这个:[[_TOC_]

您可以尝试使用这个ruby脚本从标记文件生成TOC。

 #!/usr/bin/env ruby

require 'uri'

fileName = ARGV[0]
fileName = "README.md" if !fileName

File.open(fileName, 'r') do |f|
  inside_code_snippet = false
  f.each_line do |line|
    forbidden_words = ['Table of contents', 'define', 'pragma']
    inside_code_snippet = !inside_code_snippet if line.start_with?('```')
    next if !line.start_with?("#") || forbidden_words.any? { |w| line =~ /#{w}/ } || inside_code_snippet

    title = line.gsub("#", "").strip
    href = URI::encode title.gsub(" ", "-").downcase
    puts "  " * (line.count("#")-1) + "* [#{title}](\##{href})"
  end
end

我使用这个网站markdown -TOC创建者，有些人可以粘贴他的整个markdown条目，网站自动创建所有必需的标签和TOC(内容表)，所以有些人可以很容易地复制粘贴到他自己的文档中。

对于Visual Studio Code用户来说，今天(2020年)使用的最佳选择是Markdown All in One插件(扩展)。

要安装它，启动VS Code快速打开(Control/⌘+P)，粘贴以下命令，并按enter。

ext install yzhang.markdown-all-in-one

要生成TOC，打开命令面板(Control/⌘+Shift+P)，并选择select Markdown:创建内容表选项。

另一个选择是Markdown TOC插件。

要安装它，启动VS Code快速打开(Control/⌘+P)，粘贴以下命令，并按enter。

ext install markdown-toc

要生成TOC，打开命令面板(Control/⌘+Shift+P)，并选择Markdown TOC:插入/更新选项或使用Control/⌘+MT。

您可以使用这个bash一行程序生成它。假设您的降价文件名为file .md。

echo "## Contents" ; echo ; 
cat FILE.md | grep '^## ' | grep -v Contents | sed 's/^## //' | 
  while read -r title ; do 
    link=$(echo $title | tr 'A-Z ' 'a-z-') ; 
    echo "- [$title](#$link)" ; 
    done