SABER--07 Markdown Features

Markdown Features

Saber通过markdown-it，获得内置的Markdown支持。你可以享有所有Markdown和GFM特征而不需要任何配置。

Notable Features

这里并没有记录所有Markdown特性，我们只打算记录一些值得注意的特性。

Front Matter

Front Matter 用来设置页面数据：

---
title: My Page Title
---

Markdown content goes here...

你可以使用YAML语法在front matter中。

Excerpt

Excerpt是一个可选的页面的总结或描述，你可以通过Front Matter设置它：

---
title: My Post
excerpt: This post is dedicated to the world
---

This is a wonderful world..

或者，如果没有设置，Saber将自动使用第一段或 <!-- more --> 评论作为Excerpt。

---
title: My Post
---

This is a wonderful world..

Blah blah..

然后 page.excerpt 会作为 <p>This is a wonderful world…</p>。 如果你只需要无格式文本，你可以滤掉HTML标签，而只需要用一个简单的正则表达式： html.replace(/<(?:.|\n)*?>/gm, ‘’)
如果你使用 <!-- more --> 注释，请注意这里只支持 block 注释。就是说，你不能使用 <!-- more --> 内部添加一段文字。

---
title: My Post
---

This is a wonderful world..

Isn't it?

<!-- more -->

Blah blah..

若想关闭，需要设置 excerpt 为 false 在你的页面中：

---
excerpt: false
---

Task List

输入：

- [ ] Conquer the world
- [ ] Create a website
- [x] Install Saber

输出：

注意，你也需要一些CSS去覆写默认风格的 ur 标签：

ul.task-list {
   
  list-style