GitHub Markdown TOC 生成工具。
专用于生成支持 GitHib 的 README.md 文档目录。
GitHub 所支持的 Markdown 并不支持使用 [TOC]
标签渲染目录,那么可以借此工具生成。
指定一个后缀为 .md 的文件,目录将被打印出来,复制到 Markdown 文档最上方即可。
java -jar MarkdownTocCreator.jar XXX.md
本人所有仓库的文档都会用这个工具生成目录,例如 https://github.com/l0neman/program-notes 仓库。
- 依据 Markdown 语法,出现在
#
后面的标题将作为目录出现; - 标题
# 你好
的目录格式为- [你好](#你好)
,小括号内为标题的索引,点击可跳转到标题处; - 特殊符号在标题的索引中将被替换为
""
;空格将被替换为"-"
,大写字母将被替换为小写; - 如果标题重复,那么第一次出现的标题索引保持不变,后续标题索引依次追加
-1
,-2
依次类推。
- 标题必须符合标准格式,
#
符号和标题文字本身之间必须有一个空格。
# 一级标题
## 二级标题
- 最多支持四层标题,即
#### 四级标题
,太多层次也没有意义。
Copyright 2020 l0neman
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.