【引自ideras.me的博客】前言

隨著wordpress和靜態(tài)網(wǎng)站的流行，markdown被用的越來(lái)越多。

markdown是一個(gè)面向?qū)懽鞯恼Z(yǔ)法引擎，markdown的最終目的都是解析成html用于網(wǎng)頁(yè)瀏覽，所以它兼容html語(yǔ)法，即你可以在 markdown文檔中使用原生的html標(biāo)簽。

markdown解析器

開發(fā)靜態(tài)網(wǎng)站生成器的時(shí)候都會(huì)采用一種叫front matter的格式進(jìn)行網(wǎng)站內(nèi)容寫在類似下面的格式

 
 

  
  
---
  
  
title: 玩轉(zhuǎn)markdown，你需要用到這幾個(gè)工具
  
  
date: 2016-08-14 16:44:54
  
  
image: /img/pencils-762555_640.jpg
  
  
---
  
  

  
  
## 前言
  
  

  
  
隨著wordpress和靜態(tài)網(wǎng)站的流行，markdown被用的越來(lái)越多。...
 
 

 當(dāng)進(jìn)行網(wǎng)站生成的時(shí)候需要進(jìn)行markdown解析，然后渲染成html頁(yè)面，那用什么工具進(jìn)行解析呢?

marked

marked是最早用node.js開發(fā)的markdown解析器，同時(shí)提供CLI命令調(diào)用和node.js api調(diào)用。

CLI調(diào)用代碼示例

 
 

  
  
$ marked -o hello.html
  
  
hello world
  
  
^D
  
  
$ cat hello.html
  
  
hello world
 
 

 API調(diào)用示例

 
 

  
  
var marked = require('marked');
  
  
console.log(marked('I am using __markdown__.'));
  
  
// Outputs: 
I am using markdown.
 
 

 這些都是一些通用的功能，但是marked還支持代碼高亮，通過使用highlight.js。

使用highlight.js進(jìn)行代碼高亮相信大家都用到過，可能大家不知道是highlight.js還支持api方式調(diào)用，下面的代碼會(huì)配置marked使用highlight.js進(jìn)行代碼高亮相信大家都用到過，可能大家不知道是highlight

 
 

  
  
marked.setOptions({
  
  
  highlight: function (code, lang) {
  
  
    var res;
  
  
    if (lang) {
  
  
      res = hljs.highlight(lang, code, true).value;
  
  
    } else {
  
  
      res = hljs.highlightAuto(code).value;
  
  
    }
  
  
    return res;
  
  
  }
  
  
});
 
 

 生成的代碼已經(jīng)包含代碼高亮標(biāo)簽，最后只需要引入highlight.js的主題就能顯示了，highlight.js所有的顏色主題都在這里

markdown-js

markdown-js也是一款使用node.js開發(fā)的markdown解析器，基本用法和marked差不多，但是文檔里面好像沒有提到像marked一樣進(jìn)行代碼高亮生成的接口，有興趣的同學(xué)自己找找吧。

markdown生成器

to-markdown

什么是markdown生成器，就是根據(jù)html標(biāo)簽生成markdown文件。

github上面markdown生成器star數(shù)最高的是to-markdown。

簡(jiǎn)單的代碼示例

 
 

  
  
var toMarkdown = require('to-markdown');
  
  
toMarkdown('
Hello world!
');
 
 

 to-markdown最近進(jìn)行了更新，增加了對(duì)gfm的兼容，gfm就是git flavored markdown的意思， 是github對(duì)markdown語(yǔ)法進(jìn)行了擴(kuò)展。

使用gfm的示例

 
 

  
  
toMarkdown('Hello world!', { gfm: true });
 
 

那這個(gè)to-markdown有什么用呢?

舉個(gè)簡(jiǎn)單的例子，假如我想開發(fā)一個(gè)簡(jiǎn)單的rss閱讀器，但是我又不想跳轉(zhuǎn)到目標(biāo)網(wǎng)站去閱讀，因?yàn)椴煌木W(wǎng)站風(fēng)格不一，導(dǎo)致不一致的閱讀體驗(yàn)。

怎么辦呢?那就把網(wǎng)站內(nèi)容抓取下來(lái)，然后用to-markdown生成markdown文件，然后使用自己的模板樣式進(jìn)行統(tǒng)一渲染。

當(dāng)然去除廣告只是一個(gè)side effect。

heckyesmarkdown

除了to-markdown之外還有一個(gè)比較好用的api，heckyesmarkdown，這個(gè)項(xiàng)目使用了php-readability，提高文章的可讀性。

可惜heckyesmarkdown沒有開源出來(lái)，這個(gè)項(xiàng)目有點(diǎn)古老，估計(jì)那個(gè)時(shí)候github還沒流行起來(lái)。

heckyesmarkdow對(duì)中文的支持不是非常友好，如果想抓取中文站還是使用to-markdown比較靠譜一點(diǎn)。

front matter

markdown寫文章確實(shí)很方便，簡(jiǎn)單容易上手，但是markdown不能保存元數(shù)據(jù)，例如作者，日期，類型這樣的結(jié)構(gòu)化的數(shù)據(jù)如果都生成html標(biāo)簽的話提取的時(shí)候又稍微麻煩了點(diǎn)， 還得借助cheerio才能完成。

所以，為了能方便的保存文章的元數(shù)據(jù)，幾乎所有的靜態(tài)網(wǎng)站生成器都使用front matter格式來(lái)保存文章。

front matter文件通常分為頭部和正文部分，頭部一般使用yaml、toml和json三種格式，front matter 解析工具需要識(shí)別這三種格式的文件頭。正文部分就是普通的markdown內(nèi)容。

front-matter

front-matter也是用node.js開發(fā)的，相比markdown解析器來(lái)說(shuō)，fornt-matter解析器要簡(jiǎn)單很多。

示例文件 example.md

 
 

  
  
---
  
  
title: Just hack'n
  
  
description: Nothing to see here
  
  
---
  
  

  
  
This is some text about some stuff that happened sometime ago
 
 

 解析代碼

 
 

  
  
var fs = require('fs')
  
  
  , fm = require('front-matter')
  
  

  
  
fs.readFile('./example.md', 'utf8', function(err, data){
  
  
  if (err) throw err
  
  

  
  
  var content = fm(data)
  
  

  
  
  console.log(content)
  
  
})
 
 

 
 

  
  
{
  
  
    attributes: {
  
  
        title: 'Just hack\'n',
  
  
        description: 'Nothing to see here'
  
  
    },
  
  
    body: '\nThis is some text about some stuff that happened sometime ago',
  
  
    frontmatter: 'title: Just hack\'n\ndescription: Nothing to see here'
  
  
}
 
 

 front matter雖然格式看起來(lái)不太統(tǒng)一，卻是對(duì)markdown強(qiáng)有力的補(bǔ)充。

文章題目：玩轉(zhuǎn)markdown，你需要用到這幾個(gè)工具
路徑分享：http://www.dlmjj.cn/article/dpiscce.html