markdown 写技术文档以及左侧树

#准备工作
最近准备开始编写技术文档,现在基本上都是开始使用md了,之前使用开源中国的文档编辑来做的,但是最近他的服务关闭了,然后转移到码云的企业版本了,不太想用企业版本服务就想找找其他的,现在使用的是vscode
依赖的插件
markdown previews enhancde 用来预览和生产html
markdown table prettifier 用来格式化biaoge
markdwon toc 用来生产文档 (需要把) file的eol换为\n settings修改
装上这些工具及可以写自己的文档了
#生成左侧树
这个工具真的是不好找,基本上网上都
https://github.com/i5ting
这个哥们五年前写的一套,但是文档有好多不是很好
然后找到了
https://github.com/huyande/MarkdownTemplate
这个几个月前的数据,有了很大的提升,使用之后有bug,并且每次贴进去有点繁琐,我有自己的网站,每次复制进去感觉很麻烦,因为html也是每次都生成的,然后就有了自己改的版本

$(document).ready(function(){
			$(".markdown-body").load("生成的文档",function(){
				$('#tree').ztree_toc({
                is_auto_number:false,
                documment_selector:'.markdown-body',
                is_expand_all: true
            });
			$('#readme').height($('.markdown-preview div').height() + 500);
			setTimeout(function(){
				$('#readme').height($('.markdown-preview div').height() + 500);
			},2000)
			});
        });

只要把自己生成的文件换下文件名就可以了
#流程

  1. vscode 安装插件
  2. 编写自己的文档,需要自己带标题
  3. 生成html
  4. 把自己的html名称到这个html替换下
  5. 发布,以后只需要发布自己的html就可以了

你可能感兴趣的:(markdown 写技术文档以及左侧树)