如何在 Markdown 中生成目录树?

在一个项目的 README 中,我们往往会想把项目的目录结构进行一下介绍或者注释,这样方便其他人接手项目时快速熟悉,同时也方便自己回忆起项目结构。那么效果比较好的呈现方式自然就是目录树,如何快速生成项目的目录树呢?(此篇仅针对 MacOS

tree 命令

MacOS 并不自带 tree 命令,因此我们需要手动安装一下。

安装
$ brew install tree
复制代码
使用
$ tree
复制代码

灵活用法

仅仅是上面这样使用可能没法满足一些情况下的需求。

  • 如何输出指定层级的目录树?

    直接使用 tree 命令,它会把所有层级都输出,但如果我们只要输出 2 个层级就可以了,那么可以这样使用:

    // -L level 表示只会遍历到指定层级
    $ tree -L 2
    复制代码
  • 如何忽略某些文件夹输出目录树?

    前端项目基本都会有这个问题,就是会把 node_modules 也输出成目录树,一下子目录树会无比巨大,而且一般我们也并不需要输出这个文件夹下的内容,那么可以这样使用:

    // -I pattern 表示不会将匹配到的文件/文件夹输出,即类似 ignore 的功能
    $ tree -I node_modules
    复制代码

当然可能还有其他场景,这时候你可以查看这个命令的说明:

tree --help 来看看还有什么参数是可以满足需求的,可用的参数还是非常多的。

转载于:https://juejin.im/post/5c1748d86fb9a049c43d939f

在 Vue 使用 Markdown 生成文档时,可以通过以下步骤自动生成侧边栏目录: 1. 在项目安装 `markdown-it` 和 `markdown-it-anchor` 库: ```bash npm install markdown-it markdown-it-anchor --save ``` 2. 在 Vue 组件引入并初始化 `markdown-it` 和 `markdown-it-anchor`: ```javascript import MarkdownIt from 'markdown-it' import MarkdownItAnchor from 'markdown-it-anchor' const md = new MarkdownIt({ html: true, linkify: true, typographer: true, }) md.use(MarkdownItAnchor) ``` 3. 在 Vue 组件使用 `v-html` 指令渲染 Markdown 文本,并使用 `@hook:mounted` 钩子函数监听渲染完成事件,在事件处理函数获取文档所有标题标签(如 `h1`、`h2` 等),并根据标题级别生成目录: ```html <template> <div> <div v-html="html"></div> <div class="sidebar"> <ul> <li v-for="item in toc" :key="item.id"> <a :href="'#' + item.id">{{ item.text }}</a> <ul v-if="item.children"> <li v-for="child in item.children" :key="child.id"> <a :href="'#' + child.id">{{ child.text }}</a> </li> </ul> </li> </ul> </div> </div> </template> <script> export default { data() { return { html: '', toc: [], } }, mounted() { this.html = md.render('# Hello World\n## Introduction\n### Features\n### Installation\n## Usage\n## API Reference') this.$nextTick(() => { const headers = Array.from(document.querySelectorAll('h1, h2, h3, h4, h5, h6')) this.toc = headers.map(header => ({ id: header.id, text: header.textContent, level: Number(header.tagName[1]), })).reduce((acc, header) => { let lastItem = acc[acc.length - 1] if (!lastItem || header.level <= lastItem.level) { acc.push(header) } else { let parent = lastItem while (parent.children && header.level > parent.level) { parent = parent.children[parent.children.length - 1] } if (!parent.children) { parent.children = [] } parent.children.push(header) } return acc }, []) }) }, } </script> ``` 4. 在 Vue 组件的样式定义侧边栏样式: ```css .sidebar { position: fixed; top: 0; right: 0; bottom: 0; width: 200px; padding: 20px; overflow-y: auto; } ``` 这样就可以在 Vue Markdown 文档自动生成侧边栏目录了。当然,这只是一个简单的示例,实际项目可能需要根据具体需求进行一些定制化调整。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值