前端如何实现.md文件转换成.html文件

Posted 2021-03-30 Java研究所

点击上方关注 “Java研究所”

设为“星标”，和你一起掌握更多数据库知识

.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" 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>
   
     
     
   
 
   
   
 

本文完~

往期回顾

·END·

 
   
   
 

  
    
    
  
 
   
 
    
 
     扫描二维码 ｜ 关注我们