相思资源网 Design By www.200059.com

玩转markdown 分享几个需要用到的工具

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

随着wordpress和静态网站的流行,markdown被用的越来越多。

markdown是一个面向写作的语法引擎,markdown的最终目的都是解析成html用于网页浏览,所以它兼容html语法,即你可以在 markdown文档中使用原生的html标签。

markdown解析器

开发静态网站生成器的时候都会采用一种叫front matter的格式进行网站内容写在类似下面的格式

--- 
2.title: 玩转markdown,你需要用到这几个工具 
3.date: 2016-08-14 16:44:54 
4.image: /img/pencils-762555_640.jpg 
5.--- 
6. 
7.## 前言 
8. 
9.随着wordpress和静态网站的流行,markdown被用的越来越多。... 

当进行网站生成的时候需要进行markdown解析,然后渲染成html页面,那用什么工具进行解析呢"htmlcode">

$ marked -o hello.html 
hello world 
^D 
$ cat hello.html 
<p>hello world</p>

API调用示例

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

这些都是一些通用的功能,但是marked还支持代码高亮,通过使用highlight.js。

使用highlight.js进行代码高亮相信大家都用到过,可能大家不知道是highlight.js还支持api方式调用,下面的代码会配置marked使用highlight.js进行代码高亮相信大家都用到过,可能大家不知道是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; 
 } 
}); 

生成的代码已经包含代码高亮标签,最后只需要引入highlight.js的主题就能显示了,highlight.js所有的颜色主题都在这里

markdown-js

markdown-js也是一款使用node.js开发的markdown解析器,基本用法和marked差不多,但是文档里面好像没有提到像marked一样进行代码高亮生成的接口,有兴趣的同学自己找找吧。

markdown生成器

to-markdown

什么是markdown生成器,就是根据html标签生成markdown文件。

github上面markdown生成器star数最高的是to-markdown。

简单的代码示例

var toMarkdown = require('to-markdown'); 
toMarkdown('<h1>Hello world!</h1>'); 

to-markdown最近进行了更新,增加了对gfm的兼容,gfm就是git flavored markdown的意思, 是github对markdown语法进行了扩展。

使用gfm的示例

toMarkdown('<del>Hello world!</del>', { gfm: true }); 

那这个to-markdown有什么用呢"htmlcode">

--- 
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虽然格式看起来不太统一,却是对markdown强有力的补充。

标签:
markdown

相思资源网 Design By www.200059.com
广告合作:本站广告合作请联系QQ:858582 申请时备注:广告合作(否则不回)
免责声明:本站文章均来自网站采集或用户投稿,网站不提供任何软件下载或自行开发的软件! 如有用户或公司发现本站内容信息存在侵权行为,请邮件告知! 858582#qq.com
相思资源网 Design By www.200059.com

评论“玩转markdown 分享几个需要用到的工具”

暂无玩转markdown 分享几个需要用到的工具的评论...

稳了!魔兽国服回归的3条重磅消息!官宣时间再确认!

昨天有一位朋友在大神群里分享,自己亚服账号被封号之后居然弹出了国服的封号信息对话框。

这里面让他访问的是一个国服的战网网址,com.cn和后面的zh都非常明白地表明这就是国服战网。

而他在复制这个网址并且进行登录之后,确实是网易的网址,也就是我们熟悉的停服之后国服发布的暴雪游戏产品运营到期开放退款的说明。这是一件比较奇怪的事情,因为以前都没有出现这样的情况,现在突然提示跳转到国服战网的网址,是不是说明了简体中文客户端已经开始进行更新了呢?