.md文件是markdown的一种标记语言,和html比较起来,更简单快捷,主要体现在:标记符的数量和书写上。
标记符的数量:html文档需要用到数量繁多的标记符,再辅以css来控制样式和排版,而markdown文档只需要四个基本的标记符号就能完成同样的事。 标记符的书写:HTML文档内容需要同时标记开始和结束这是一个网页,而markdown文档则只要在开始位置标记即可# 这是一个md文档。
下面介绍如何实现将.md文件转换成.html文件。
方式一:使用i5ting_toc插件
需要先安装npm(安装node.js后会自带npm),然后才能安装i5ting插件:
代码语言:javascript复制npm install i5ting_toc -g
执行命令行生成html文件,在输入前要进入到对应根目录下:
代码语言:javascript复制i5ting_toc -f **.md
需要注意的是:写md文档的特殊符号时记得添加空格。
小技巧:如何快速在当前目录打开cmd?选择当前目录,按住shift,然后鼠标右键在此处打开命令窗口(在此处打开powerShell窗口)。
方式二:使用gitbook
同样先需要安装node,然后运行
代码语言:javascript复制npm i gitbook gitbook-cli -g
生成md文件,这个命令会生成相应的md的文件,然后在相应的文件里写你的内容即可:
代码语言:javascript复制gitbook init
md转html,生成一个_doc目录,打开就可以看到你html文件了。
代码语言:javascript复制gitbook build
方式三:利用前端代码
实现原理是采用node.js搭建服务器,读取md文件转化为html片断。浏览器发送ajax请求获取片段后再渲染生成html网页。
node代码
代码语言:javascript复制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)
});
前端html:
代码语言:javascript复制<div id="content">
<h1 class="title">md-to-HTML web app</h1>
<div id="article">
</div>
</div>
<script type="text/JavaScript" src="js/jquery-1.11.3.min.js"></script>
<script>
var article = document.getElementById('article');
$.ajax({
url: "/getMdFile", success: function(result) {
console.log('数据获取成功');
article.innerHTML = JSON.parse(result).body;
}, error: function (err) {
console.log(err);
article.innerHTML = '<p>获取数据失败</p>';
}
});
</script>
本文完~