Vim 编辑 markdown 侧边栏显示 toc 二级标题目录

文章目录

    最近在写的 markdown 文档越来越长,文档一长就显得杂乱无章。
    如果能像 word 一样,在侧边栏显示各级标题,结构能清晰不少。
    而且,我也只用二级标题,应该更清楚才对。

    vista.vim

    虽然 vista.vim 主要用于代码文件的函数、变量、类列表展示。
    但是其内置了 markdown 的子标题的展示功能。看了一下截图效果非常好,于是决定试一下。

    https://github.com/liuchengxu/vista.vim

    安装 vista.vim

    如果用的 vundle, vimrc 中配置; 用 Neovim 修改 init.vim

    Plugin 'liuchengxu/vista.vim'
    

    执行

    :PluginInstall
    

    展示目录

    :Vista
    

    效果如图:

    vim markdown toc

    隐藏

    :Vista!
    

    用于代码文件展示函数列表

    其他语言提示必须安装 ctags

    sudo apt install universal-ctags
    

    效果如图:

    vim python vista

    生成 toc

    toc 即 Table of Contents

    github 上很多项目的 readme 文件中都有 toc 部分。
    我自己的感受是,如果 markdown 内容过多,还是有个 toc 比较方便浏览。

    生成 toc 的插件,而且支持中文:

    https://github.com/mzlogin/vim-markdown-toc

    但是我生成的 html 没有 id 的支持啊。。。
    不行在前端用 js 实现一下。

    关于作者 🌱

    我是来自山东烟台的一名开发者,有感兴趣的话题,或者软件开发需求,欢迎加微信 zhongwei 聊聊,或者关注我的个人公众号“大象工具”, 查看更多联系方式