vlambda博客
学习文章列表

来源 | http://www.fly63.com/article/detial/9641

.md文件是markdown的一种标记语言，和html比较起来，更简单快捷，主要体现在：标记符的数量和书写上。

标记符的数量：html文档需要用到数量繁多的标记符，再辅以css来控制样式和排版，而markdown文档只需要四个基本的标记符号就能完成同样的事。
标记符的书写：HTML文档内容需要同时标记开始和结束这是一个网页，而markdown文档则只要在开始位置标记即可# 这是一个md文档。

下面介绍如何实现将.md文件转换成.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)});
 
   
   
 

前端html：

 
   
   
 

  
    
    
  
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
   
 
  
  
    
    
  
<div id="content"> <h1 class="title">md-to-HTML web app</h1> <div id="article"> </div></div><script type="text/JavaScript" ></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>