lupeng 2020-11-14
.md文件是markdown的一种标记语言,和html比较起来,更简单快捷,主要体现在:标记符的数量和书写上。
方式一:使用i5ting_toc插件
需要先安装npm(安装node.js后会自带npm),然后才能安装i5ting插件:
npm install i5ting_toc -g
执行命令行生成html文件,在输入前要进入到对应根目录下:
i5ting_toc -f **.md
需要注意的是:写md文档的特殊符号时记得添加空格。小技巧:如何快速在当前目录打开cmd?选择当前目录,按住shift,然后鼠标右键在此处打开命令窗口(在此处打开powerShell窗口)。
方式二:使用gitbook
同样先需要安装node,然后运行:
npm i gitbook gitbook-cli -g
生成md文件,这个命令会生成相应的md的文件,然后在相应的文件里写你的内容即可:
gitbook init
md转html,生成一个_doc目录,打开就可以看到你html文件了。
gitbook build
方式三:利用前端代码
实现原理是采用node.js搭建服务器,读取md文件转化为html片断。浏览器发送ajax请求获取片段后再渲染生成html网页。
node代码:
var express = require('express'); var http = require('http'); var fs = require('fs'); var bodyParser = require('body-parser'); var marked = require('marked'); // 将md转化为html的js包 var app = express(); app.use(express.static('src')); //加载静态文件 var urlencodedParser = bodyParser.urlencoded({ extended: false }); app.get('/getMdFile',urlencodedParser, function(req, res) { var data = fs.readFileSync('src/test.md', 'utf-8'); //读取本地的md文件 res.end(JSON.stringify({ body : marked(data) })); } ); //启动端口监听 var server = app.listen(8088, function () { var host = server.address().address; var port = server.address().port; console.log("应用实例,访问地址为 http://%s:%s", host, port) });