Markdown-It-Toc-Done-Right 开源项目教程

76 0 0

Markdown-It-Toc-Done-Right 开源项目教程

markdown-it-toc-done-rightA table of contents (TOC) plugin for Markdown-it with focus on semantic and security. Made to work gracefully with markdown-it-anchor.项目地址:https://gitcode.com/gh_mirrors/ma/markdown-it-toc-done-right

本教程旨在引导您了解并使用 markdown-it-toc-done-right 这一强大的Markdown TOC（目录）插件。通过深入探讨其目录结构、启动与配置细节，帮助您高效集成自动生成且高度可定制的目录功能到您的Markdown文档中。

1. 项目的目录结构及介绍

项目采用Node.js开发，核心逻辑封装在src/toc.js中，而index.js作为外部使用的入口，简化了使用流程。test目录对于开发者理解插件的工作机制非常有帮助，但日常使用者则更多关注文档和源码中的API调用方式。

2. 项目的启动文件介绍

虽然直接运行此项目作为一个独立应用的需求不多见，因为其主要作为Markdown解析库的插件来使用，但它的启动通常指的是在本地进行开发或测试环境下的配置和执行。这主要是通过npm脚本来完成的，如：

使用npm install安装所有依赖。
开发者可能运行npm test来验证插件功能是否正常。
若要在自己的Markdown处理流程中使用，不直接“启动”该项目，而是将其作为依赖添加至您的项目，并在代码中引入和配置它。

3. 项目的配置文件介绍

主要配置：package.json

依赖与脚本：此文件不仅列出项目所需的所有npm依赖项，还定义了一系列脚本命令，比如构建、测试等自动化操作。

插件使用配置

实际使用中，配置发生在您自己的项目中，通过Markdown解析器（如markdown-it）的实例化过程中加入此插件并设置选项：


const markdownIt = require('markdown-it');
const toc = require('markdown-it-toc-done-right');
 
markdownIt()
  .use(toc, {
    maxDepth: 3,       // 可调整的最大标题层级
    bullets: '- ',      // 目录条目的符号
    anchorLinkSymbol: '', // 是否显示锚点链接，默认为'
    slugify: (str) => str.toLowerCase().replace(/[^ws-]/g,''), // 自定义slug化规则
  });