NijiPress
你现在就在浏览 (如果不是通过 Reader 之类的查看这篇文章的话) 我自制的, 山寨 WordPress 的, 实际上挂载在 Google AppEngine 上的, 文章格式完全靠 markdown 的 NijiPress 系统上的文章. (即使通过 Reader, 你看到的文章内容版式也是经由 markdown 转换的结果)这篇文章将谈谈其中的 markdown 语法.
NijiText
NijiPress 的 markdown 内核叫做 NijiText. 不得不说 NijiText 中有些 markdown 语法确实很非主流, 对于下面出现的各种魑魅魍魉, 还请高抬贵槽.行中转换
超链接
@@ http://example.org/ @Example@@ ==> Example语法为 @@链接@文字@@.
强调
将文字包入 strong 标签**需要加粗的文字** ==> 需要加粗的文字
行中代码
将文字包入 tt 标签``text im+-*/`` ==>
text im+-*/这里的引号为标准键盘主键区数字 1 左边那个.
上下标
将文字包入 sub 或 sup 标签,,下标,,
^^上标^^
a,,2,,x^^2^^+a,,1,,x+a,,0,,=0 ==> a2x2+a1x+a0=0
删除线
将文字包入 s 标签--删除线-- ==>
斜体
将文字包入 i 标签///italic/// ==> italic
因为许多编程语言中, 双斜杠 // 表示单行注释, 为了避免纠结的转义, 所以斜体设计为三个斜杠.
转义
将反斜杠放在与 markdown 语法相关的特殊字符前转义该字符这段文字 *\* 不会被加粗, *\* 反斜杠本身 \\ 转义 ==> 这段文字 ** 不会被加粗 **, 反斜杠本身 \ 转义
Headings
当某一行由 1~3 个等号 (=) 开头, 且等号后加上一个空格, 那么这些符号之后的内容将被转换为标题.= Heading 1
== Heading 2
=== Heading 3
代码块
用仅 {{{ 和仅 }}} 将多行内容括起来时, 中间的内容将会变为一个代码块{{{
code line 0
code line 1
}}}
==>
code line 0
code line 1
ASCII Art
如果一行由一个冒号一个空格开头, 这一行将被解析为一行 AA 内容. AA 内容中的转义字符 (\) 和任何行中转义将被忽略. 连续多个这样的行将被合并为一块 AA 内容.: . |
: |\ |
: | \|
: | `
. |
|\ |
| \|
| `
表格
用仅 [[[ 和仅 ]]] 将多行内容括起来时, 中间的内容将会变为一个表格, 每行内容将被转换成一个 tr. 中间的单元格用 || 分隔. 下面是一些例子一般表格:
[[[
||单元格||单元格
||第二行||...
]]]
==>
| 单元格 | 单元格 |
| 第二行 | ... |
更复杂地, 为单元格加上跨行跨列内容对齐等属性:
[[[
||;hcr2;hori-align 为 top 且跨 2 行||cell
||row 2||...
||row 333333333333333333333333333333||...
]]]
==>
| hori-align 为 center 且跨 2 行 | cell |
| row 2 | ... |
| row 333333333333333333333333333333 | ... |
单元格属性可以用如下产生式表示:
Semicolon ( Attribute )+ Semicolon CellContent
Attribute: AttributeTag AttributeValue
AttributeTag: c|r|h|v
AttributeTag 还是 AttributeValue 都是大小写敏感的 (应该使用小写).当
AttributeTag 为 c 或 r, AttributeValue 应该是 2~9, 表示跨的列或行数;当
AttributeTag 为 h, AttributeValue 应该是 l (left align), r (right align), j (justified) 或 c (center align);当
AttributeTag 为 v, AttributeValue 应为 t (top align), b (bottom align), m (middle) 或 l (base line).无序列表
如果一行以一个星号 (*) 和一个空格开头, 那么这一行会被转为一个无序列表. 连续多个这样的行将被合并为一个列表.* 一个项目
* 另一个项目
==>
- 一个项目
- 另一个项目
