如何将一个world或markdown文档转成一个html文件并渲染到页面上，并添加侧边栏目录

        在开发时有时需要将非开发人员写的word文档显示到页面上，比如说软件的帮助文档，又或者时说明文档一类的页面。

        如果文档很长，做为一个开发人员不可能一行一行的再把文档写成代码，还要设置样式，这样做会费时费力。

        这里有两种方案可以实现此功能，一是直接将word转换成html，二是将world转成markdown之后再转成html文件。

一、word直接转成html文件

          首先使用wps打开word文档，然后点击另存为，如下图：

         随后会产生一个html文件，需要注意的是不要用任何的编辑器去编辑这个文件，会导致乱码，需要用记事本打开，然后cv一下复制到（vs code）里，这样就解决了乱码问题，然后就ok了。

二、转换markdown，再由markdown转换成html格式

1.转换为markdown格式

        这里推荐使用Writage：下载地址：Writage - Markdown plugin for Microsoft Word。

        我再知乎上找到了一篇比较好的文章：一键！将 Word 转换为 Markdown - 知乎 (zhihu.com)

        也可以利用的一些在线word转markdown的网站直接获取，或者一些你所习惯的方式，能转换成markdown格式的文件就可以。

2.由markdown转换成html格式

需要使用到vscode开发工具，在vscode的拓展中搜索Markdown Preview Enhanced插件并安装，然后打开markdown文件，再右键打开侧边栏预览

或

 将光标放到第一行，然后按Ctrl+Shift+P打开命令面板，输入 Markdown Preview Enhanced: Create Toc 会在光标位置生成一段代码

 在第一行加上 front-matter规则，用来生成目录和侧边栏

---
html:
  	toc: true
print_background: true
---

然后在编辑-首选项-设置里搜索Enable Script Execution，将此设置打开

 以上准备工作都做完之后，在markdown预览模式下右键点击

 之后会在同目录下生成一个同名的html文件，link引入从css可以删除，不影响布局。

 打开大概是这个样子，左边是侧边栏导航，右边是内容

 如果不想单独显示在页面上可以把html文件里面的css和html文件单独拷出来使用，头文件可删除，<ul></ul>内的内容是侧边栏的目录

 结束。