附:Markdown 更多语法
Markdown是非常棒以及流行的写作语法,平文本,「易读易写」,一般只需几分钟就能学会Markdown的基本用法。
标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
分别对应HTML中的<h1>一级标题</h1>
,以此类推。
用两个星号标记起来,表示加粗,*一个星号,表示斜体*,这样子表示删除,这些就是最基本的语法了。
插入链接
只需要在网址头尾用尖括号包裹即可,比如<http://url.com>
这是一个[链接][link_key]
,然后,在文档的任何一行中(通常在文档末尾比较合适),对这个链接进行定义,比如:
这是一个 <myname@example.com>
邮箱的链接。
[Google (target=_blank id=google_link)](google.com)
其中内容括号内的target=_blank id=google_link
会自动扩展到最终 HTML 对应 A 标签下的属性,另外,google.com
作为一个域名,不需要补全http://
, 最终会自动补全。
插入图片
插入图片的语法跟插链接很像,在MarkEditor中,一般可以通过拖拽的方式进行插图,不一定会看到这个语法,而可能直接看到图片本身。
![图片的alt信息,可空)](图片的url)
的形式中,如果图片的 url 不是 Web 地址,而是本地的指向,则后面跟上?r=90&w=100&h=100
,可以设定图片的尺寸。其中 r 表示缩放90%, w 表示最大宽度 (像素),h 表示最大高度。r、w、h 并不需要全部进行声明,按需则可。
如果是图片直接在编辑区域内可见(非 Markdown 语法显示),则按住 Command 键 (Windows 版为 Ctrl 键)再点击图片,可以直接进行调整。
列表
- Red
- Green
- Blue
1. Bird
2. McHale
3. Parish
- Bird
- blue bird
- McHale
1. a man
2. HoustonRockets
- Parish
居中与居右
单独一行的时候,[文本内容]
表示居中对齐,[文本内容]]
表示居右(右侧再多一个]
),其它默认情况下都是居左。
[我是居中的文本]
[我是居右的文本]]
内容引用
用>
放在段首,之后是空格,输入文字:
> 你
> 一会看我
> 一会看云
> 我觉得
> 你看我时很远
> 你看云时很近
分割线
注释
// 这是 MarkEditor 的特别支持!
/// 多了一个/,也是注释,但最终注释内容不会出现在源码中。
注释后的内容,最终会以 HTML 的注释格式<!--我是内容-->
存在,不会显示在正文中,但包含在 HTML 的源码中;如果是///
开头的,则也不包括在源码中。
代码高亮语法
通过fenced code的方式(代码块的头尾被三个反引号包裹),然后声明代码语言类型,即可实现代码高亮。不仅仅是最终的HTML预览会处理代码高亮,实时输入的过程中也是高亮的。
```python
s = 'hello world'
```
代码语言的类型后面跟上:n
,则最终在渲染为HTML(预览)的时候,代码块会标示行数。
```python:n
s = 'hello world'
```
流程图语法
流程图的语法规则实际上是基于http://adrai.github.io/flowchart.js/实现的,只要申明语言类型为flow
即可。
但是我们认为原始插件的语法有些晦涩,所以在兼容原有语法的基础上,又重新进行了演绎,效果如下:
```flow
st: 起始
register: 注册
condition: 好人?
check: 盘查一下
end: 终了
st > condition
condition(y) > register > end
condition(n) > check > register
```
流程图原始语法
```flow
st=>start: Start
op=>operation: Your Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
```