mddir自动生成文件目录结构工具

本文介绍了如何通过mddir工具快速生成Markdown目录,演示了从安装到使用的全过程,并展示了其生成的directoryList.md文件结构。这对于整理项目文档和README.md内容非常实用。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

一、什么是mddir?

在平时写博客或者记录一个项目的时候,总是会先梳理一下项目基本机构,也就是希望展示如下所示图形

之前都是手写,很累,偶然发现一个工具可以基于项目目录结构动态生成目录机构md文件,所以特此记录一下,这个工具的使用方法。

2、安装mddir

mac安装需求权限
    sodu npm install mddir -g

windows安装
    npm install mddir -g

3、使用

安装完毕,直接进入项目根目录,执行命令 mddir 即可在根目录下生成一个directoryList.md的文件。

4、生成的 directoryList.md

5、复制放到README.md        

### 如何在 `.md` 文件中显示目录 为了使 `.md` 文件中的目录可见,可以采用自动或手动的方式生成并嵌入目录。以下是具体实现方式: #### 自动生成目录 可以通过工具自动生成目录,并将其嵌入到 `.md` 文件中。 1. **使用 `i5ting_toc` 工具** 安装该工具后,可以在命令行中执行以下操作: ```bash npm install -g i5ting_toc ``` 接着通过如下命令为指定的 `.md` 文件生成目录: ```bash i5ting_toc -f 你的文件名.md ``` 此外,还可以直接预览 `.md` 文件的效果[^2]。 2. **使用 `mddir` 工具** 如果需要生成整个项目的目录结构而非单个文件内的目录,则可考虑使用 `mddir` 工具: ```bash npm install mddir -g cd 到目标路径 mddir ``` 自动生成名为 `directoryList.md` 的文件,其中包含了完整的项目目录树结构。 #### 手动编写目录 如果不想依赖外部工具,也可以手动创建目录部分。例如: ```markdown ### 目录 1. [前言](#前言) 2. [语法详解](#语法详解) - [2.1 目录的自动生成](#目录的自动生成) - [2.2 手动书写目录](#手动书写目录) 3. [使用场景及实例](#使用场景及实例) 4. [小结](#小结) 5. [其他文章](#其他文章) ``` 上述代码片段定义了一个简单的链接列表作为文档内部导航条目,点击这些超链即可跳转至相应章节位置[^1]。 对于更复杂的 Markdown 文档来说,建议优先尝试自动化解决方案以减少维护成本;而对于小型静态页面则可能更适合采取手工调整模式来满足个性化需求。 ```python # 示例 Python 脚本用于演示如何读取 .md 文件内容并插入 TOC (Table Of Contents) def insert_toc(file_path, toc_content): with open(file_path, 'r+', encoding='utf8') as f: content = f.read() new_content = "# Table of Contents\n" + toc_content + "\n\n" + content f.seek(0) f.write(new_content) if __name__ == "__main__": file_name = "example.md" table_of_contents = """ 1. [Introduction](#introduction) 2. [Details](#details) """ insert_toc(file_name, table_of_contents) ``` 此脚本展示了怎样向现有的 Markdown 文件头部追加一个预先准备好的目录字符串。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值