使用Spec Markdown 编写手册文档

Posted rongfengliang

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了使用Spec Markdown 编写手册文档相关的知识,希望对你有一定的参考价值。

Spec Markdown 是一个基于markdown 的文档编写工具,安装简单,可以让我们编写出专业的文档

参考项目 https://github.com/rongfengliang/spec-md-demo

安装

  • 全局
npm install -g spec-md
  • 本地项目依赖
npm install --save-dev spec-md

项目使用

因为个人原因,比较喜欢使用yarn,所以项目基于yarn 初始化

  • 初始化
yarn init -y
  • 配置构建&&依赖
yarn add spec-md --dev
package.json
{
"name": "first",
"version": "1.0.0",
"main": "index.js",
"license": "MIT",
"dependencies": {
"spec-md": "^0.6.0"
},
"scripts": {
"b": "spec-md ./md/*.md > ./out/index.html",
"live":"live-server --open=./out"
},
"devDependencies": {
"live-server": "^1.2.0"
}
}
md/userlogin.md

构建&&运行

  • 构建
yarn b
  • 访问
yarn live
  • 效果
    技术分享图片

参考资料

http://leebyron.com/spec-md/
https://github.com/rongfengliang/spec-md-demo

以上是关于使用Spec Markdown 编写手册文档的主要内容,如果未能解决你的问题,请参考以下文章

Markdown使用手册基础篇

Markdown使用手册基础篇

Cmd Markdown 简明语法手册

markdown 放代码片

docfx

Markdown语言怎么用