在前端开发中，我们常常需要编写文档以便于项目开发和维护。而 solidoc 是一个基于 markdown 的文档生成器，它可以将 markdown 文档转换成美观的 HTML 网页。
安装 solidoc
在使用 solidoc 之前，我们需要先安装它。
npm install -g solidoc
创建 markdown 文档
我们可以使用任何支持 markdown 格式的文本编辑器来编写文档。下面是一个示例文档：
# 这是一个示例文档 ## 安装 运行以下命令来安装 solidoc： ```bash npm install -g solidoc
使用
运行以下命令来使用 solidoc：
solidoc path/to/your/doc.md
此命令将会在当前目录下生成一个 doc.html 文件，该文件即是转换后的 HTML 文档。
## 生成 HTML 文档 完成 markdown 文档的编写后，我们可以使用 solidoc 命令来生成 HTML 文档。在终端中执行以下命令： ```bash solidoc path/to/your/doc.md
然后，在当前目录下就会生成一个 doc.html 文件。打开该文件可以看到转换后的 HTML 文档。
添加主题
solidoc 支持通过配置文件来添加主题。在项目根目录下新建一个 solidoc.yml 文件，并添加以下内容：
theme: my-theme
这里的 my-theme 可以是现有的主题，也可以是自己定制的主题的名称。如果是自定义主题，则需要在 ~/.solidoc/themes 目录下新建一个以该主题名称命名的目录，在该目录中添加必要的静态资源文件和模板文件即可。
结语
solidoc 提供了一种方便的方式来生成漂亮的 HTML 文档，使得编写和分享文档变得更加容易。我们可以利用它来生成各种项目文档、API 文档等，提升项目的协作效率。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600668e3d9381d61a3540a64