代码、表格、制图

代码

代码高亮

通过fenced code的方式(代码块的头尾被三个反引号包裹),然后声明代码语言类型,即可实现代码高亮。不仅仅是最终的HTML预览会处理代码高亮,实时输入的过程中也是高亮的。
```python
s = 'hello world'
```

s = 'hello world'

代码语言的类型后面跟上:n,则最终在渲染为HTML(预览)的时候,代码块会标示行数。
```python:n
s = 'hello world'
```

1
s = 'hello world'

代码高亮示例

支持超过300种代码类型的高亮,以下是一些示例:

```python
from settings import world
if world == 'mine':
kept = keep(world)
```

from settings import world
if world == 'mine':
   kept =  keep(world)

```ruby
sum = 1 + 2
a, b = 1, 2
1 > 2 ? true : false; puts 'Hi'
```

sum = 1 + 2
a, b = 1, 2
1 > 2 ? true : false; puts 'Hi'

```swift
import Cocoa
let a = 4
var s = "Hello " + "World!"
```

import Cocoa
let a = 4
var s = "Hello " + "World!"

```js
var express = require('express');
var app = express();
app.get('/', function(req, res){
res.send('hello world');
});
app.listen(3000);
```

var express = require('express');
var app = express();
app.get('/', function(req, res){
  res.send('hello world');
});
app.listen(3000);

插入可运行的模板语法

在 Bitcron 中,如果代码类型申明的为 code 的话,则在文档呈现的时候,其内部的代码,会作为一个模板文件进行渲染。
```code
h2 Title
p Hello world
```

表格语法

注意: 此处介绍的是Bitcron风格的语法,更加简洁、明了。如果你了解相对通用的其它Markdown的表格语法,一般情况下,Bitcron的Markdown解析引擎也是支持的,但并不在此处具体介绍。
```table
项目 | 价格 | 描述
尺子 | ¥2 | 说明内容,也可为空
本子 | ¥8 (描述偷懒不写完第三项也可以,不会破坏表格结构)

Tip | ¥18 | hello world
```

项目 价格 描述
尺子 ¥2 说明内容,也可为空
本子 ¥8 (描述偷懒不写完第三项也可以,不会破坏表格结构)
Tip ¥18 hello world

第一行是表格的第一栏,每个项的文本中可以追加(-)(>)(<)来实现某列内的文本对齐,它们也分别等同于(center)(right)(left)
```table
项目(-) | 价格(>) | 描述(<)
尺子 | ¥20 | ?

本子 | ¥8
```

项目 价格 描述
尺子 ¥20 ?
本子 ¥8

自动制图语法

注意: 页面呈现的时候,默认不会载入Echarts脚本,需要在网站设置中进行启用。
Bitcron 支持三种类型的制图,声明 table 的时候,后面加上 line、pie、bar三者之一即可。
比如下面的 Demo (具体效果,可以查看预览)

柱状图

最简单的一个图表:
```table:bar
衬衫 | 羊毛衫 | 雪纺衫 | 裤子 | 高跟鞋 | 袜子
15 | 20 | 36 | 10 | 10 | 20
```

也可以是横向的:
```table:bar
品类 | 数量
衬衫 | 15
羊毛衫 | 20

雪纺衫 | 36
裤子 | 10
高跟鞋 | 10
袜子 | 20
```


还可以是这种横纵两个维度的:
```table:bar
季度 | 衬衫 | 羊毛衫 | 雪纺衫 | 裤子 | 高跟鞋 | 袜子
1季度 | 5 | 20 | 36 | 10 | 10 | 21
2季度 | 15 | 20 | 6 | 10 | 10 | 30
3季度上(3季度) | 2 | 2 | 16 | 8 | 6 | 30
3季度下(3季度) | 5 | 2 | 13 | 10 | 9 | 20
```
注意: 3季度上(3季度)3季度下(3季度)会自动实现归档,合并到同一个柱状图中。

线图

跟柱状图非常类似,只需要将上面柱状图的几个 demo,由table:bar改为table:line即可。

饼图

最简单的一个图表:
```table:pie
衬衫 | 羊毛衫 | 雪纺衫 | 裤子 | 高跟鞋 | 袜子
15 | 20 | 36 | 10 | 10 | 20
```

也可以是横向的:
```table:pie
品类 | 数量
衬衫 | 15
羊毛衫 | 20

雪纺衫 | 36
裤子 | 10
高跟鞋 | 10
袜子 | 20
```

自动归档:
```table:pie
品类 | 数量
衬衫(衣服) | 15
羊毛衫(衣服) | 20

雪纺衫(衣服) | 36
裤子 | 10
高跟鞋(鞋袜) | 10
袜子(鞋袜) | 20
```

流程图

注意: 页面呈现的时候,默认不会载入Flowchart的脚本,需要在网站设置中进行启用。

Bitcron风格的流程图语法

流程图的语法规则实际上是基于http://adrai.github.io/flowchart.js/实现的,只要申明语言类型为flow即可。
但是我们认为原始插件的语法有些晦涩,所以在兼容原有语法的基础上,又重新进行了演绎,效果如下:

```flow
st: 起始
register: 注册
condition: 好人?
check: 盘查一下
end: 终了

st > condition
condition(y) > register > end
condition(n) > check > register
```

流程图原始语法(示例)

更多请参考http://adrai.github.io/flowchart.js/

```flow
st=>start: Start
op=>operation: Your Operation
cond=>condition: Yes or No?
e=>end

st->op->cond
cond(yes)->e
cond(no)->op
```

2017-06-13 16:52
Comments
Write a Comment
  • 制图考虑支持 [mermaid](https://github.com/knsv/mermaid) 就太棒了

  • 制图考虑支持 [mermaid](https://github.com/knsv/mermaid) 就太棒了!