除了 Markdown 编辑器,你还需要会用程序来处理它
2016-08-27 18:38
274 查看
前言
随着 wordpress 和静态网站的流行,markdown 被用的越来越多。我们已经介绍过很多 Markdown 编辑器,但是有时候你也需要用程序来处理 Markdown 文本。markdown 是一个面向写作的语法引擎,markdown 的最终目的都是解析成 html 用于网页浏览,所以它兼容 html 语法,即你可以在 markdown 文档中使用原生的 html 标签。
markdown 解析器
开发静态网站生成器的时候都会采用一种叫 front matter 的格式进行网站内容写在类似下面的格式--- title: 玩转markdown,你需要用到这几个工具 date: 2016-08-14 16:44:54 image: /img/pencils-762555_640.jpg --- ## 前言 随着wordpress和静态网站的流行,markdown被用的越来越多。...
当进行网站生成的时候需要进行 markdown 解析,然后渲染成 html 页面,那用什么工具进行解析呢?
marked
marked 是最早用 node.js 开发的 markdown 解析器,同时提供 CLI 命令调用和 node.js API 调用。CLI 调用代码示例
$ 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 进行代码高亮:
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 有什么用呢?
举个简单的例子,假如我想开发一个简单的 RSS 阅读器,但是我又不想跳转到目标网站去阅读,因为不同的网站风格不一,导致不一致的阅读体验。
怎么办呢?那就把网站内容抓取下来,然后用 to-markdown 生成 markdown 文件,然后使用自己的模板样式进行统一渲染。
当然去除广告只是一个 side effect。
heckyesmarkdown
除了 to-markdown 之外还有一个比较好用的 API: heckyesmarkdown,这个项目使用了 php-readability,提高文章的可读性。可惜 heckyesmarkdown 没有开源出来,这个项目有点古老,估计那个时候 github 还没流行起来。
heckyesmarkdow 对中文的支持不是非常友好,如果想抓取中文站还是使用 to-markdown 比较靠谱一点。
front matter
markdown 写文章确实很方便,简单容易上手,但是 markdown 不能保存元数据,例如作者,日期,类型这样的结构化的数据,如果都生成 html 标签的话提取的时候又稍微麻烦了点, 还得借助 cheerio 才能完成。所以,为了能方便的保存文章的元数据,几乎所有的静态网站生成器都使用 front matter 格式来保存文章。
front matter 文件通常分为头部和正文部分,头部一般使用 yaml、toml 和 json 三种格式,front matter 解析工具需要识别这三种格式的文件头。正文部分就是普通的 markdown 内容。
front-matter
front-matter 也是用 node.js 开发的,相比 markdown 解析器来说,fornt-matter 解析器要简单很多。示例文件 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 虽然格式看起来不太统一,却是对 markdown 强有力的补充。
相关文章推荐
- WinCE 中关于16BPP和24BPP之间的差别以及程序处理需要注意的地方 (转贴)
- 升级安装Windows7后需要处理的兼容性程序(不断更新中)
- 菜鸟教程投稿页面的Markdown编辑器—可插入程序代码
- 在小程序中使用md5处理需要加密的字符串(含中文的字符串)
- CSDN的MarkDown编辑器中关于水印的处理
- CSS解析器,如果需要在程序中处理CSS,则可以用到。
- 如何在原生微信小程序中实现数据双向绑定欢迎使用CSDN-markdown编辑器
- Markdown编辑器博客被覆盖应急处理
- 如何使用MarkDown编辑器!!!对发程序博文大有帮助
- 使用Markdown编辑器写博客需要注意到的操作
- 除了写程序,你还需要更多
- 一般处理程序获取WEB窗体创建的验证码需要实现session相关接口
- SQL Server 2005“错误1706。安装程序找不到需要的文件。请检查……”的处理办法
- 使用CSDN-markdown编辑器需要掌握的知识
- linux中断处理程序需要注意的参数问题
- ruby程序处理HTML编辑器内容只保留类似UBB的内容
- 可变变量常用用于在写程序的时候不确定需要用哪个变量去处理数据的情形
- SQL Server 2005“错误1706。安装程序找不到需要的文件。请检查……”的处理办法
- InstallShield安装包制作笔记:判断安装时需要重写或者删除的程序是否打开并处理
- 错误:“ResourceDictionary”根元素需要 x:Class 特性来支持 XAML 文件中的事件处理程序。请移除 MouseLeftButtonDown 事件的事件处理程序.