Browse Source

继续撰写基本语法

zry 8 years ago
parent
commit
f050f0bd02
1 changed files with 70 additions and 1 deletions
  1. 70 1
      BasicSyntax/BasicSytax.md

+ 70 - 1
BasicSyntax/BasicSytax.md

@@ -24,6 +24,10 @@
 
 如果您有一行文本,它很长,书写的时候您想分成几行书写,但希望显示出来的效果仍然是一行,您可以使用续行符。在新的一行前面加上+=两个符号,即可实现续行。注意+=之前不应该有其它字符。从+=到您书写的第一个可显示字符之间的空白符会被忽略。
 
+### 缩进
+
+缩进指在行首出现的一个或连续几个空白符,在ZumDown中,缩进通常会被忽略。如果您想在文中利用缩进产生层级视觉效果,请使用原本在Markdown中代表区块引用的\>号,在ZumDown中它将代表一个制表符的缩进。关于缩进和区块引用的详细说明请看本文档的《与Markdown不兼容的特性》部分。
+
 ## Markdown已有的样式功能
 
 ### 纯文本
@@ -38,4 +42,69 @@
 
 如果您需要输入的一些可显示字符,而它对于HTML来说是特殊字符,ZumDown渲染器会自动将其转换为HTML实体。
 (注意同转义区分,转义是针对ZumDown语法字符,如果您输入的是ZumDown语法字符,需要手动加上转义符\\,而不会自动转义)
-书写时写的HTML实体本身可以被保留,例如您想插入一个版权标记 © ,输入`©`并在前后各留一个空白符即可。
+书写时写的HTML实体本身可以被保留,例如您想插入一个版权标记 © ,输入`©`并在前后各留一个空白符即可。
+
+### 标题
+
+有两种写法,均和Markdown相同(这两种分别被称作类Setext和类atx形式)。
+
+类 Setext 形式:
+
+```code:zumdown
+
+大标题
+=============
+
+二级标题
+-------------
+
+```
+
+显示效果:
+
+>大标题
+>=============
+>
+>二级标题
+>-------------
+
+类 atx 形式:
+
+```code:zumdown
+
+# 这是 大标题
+
+## 这是 二级标题
+
+###### 这是 六级标题
+
+```
+
+显示效果:
+
+># 这是 大标题
+>
+>## 这是 二级标题
+>
+>###### 这是 六级标题
+
+
+## 与Markdown不兼容的特性
+
+值得注意的是,ZumDown虽然兼容大部分Markdown语法语义,但并不是完全兼容,这里特意将不能兼容的部分及替代方法整理出来加以介绍。
+
+### 区块引用
+
+原本在Markdown中代表区块引用的\>号,在ZumDown中用于替代制表符缩进。而您如果想使用区块引用功能,请参照“Superblock”
+
+### 缩进和代码区块
+
+在ZumDown和部分其它的Markdown方言中,缩进通常都会被忽略。如果您想在文中利用缩进产生层级视觉效果,请使用原本在Markdown中代表区块引用的\>号,在ZumDown中它将代表一个制表符的缩进。
+
+如果是在标准的Markdown中,四个空格或一个制表符代表的缩进是“代码块”,而该功能在ZumDown和部分其它的Markdown方言中被禁用。如果您想显示一些源代码,请参照文档的Superblock部分对code区块的介绍。
+
+原本的另一种形式的代码区块,即一对三个\`号包括的代码块,在ZumDown中被定义为Superblcok,它具备有丰富的功能,其中也包括了Markdown原本所提供的代码区块功能,只是使用稍有不同。关于Superblock的使用请参照本文档的Superblock部分。
+
+### 换行符与续行符
+
+如果您有一行文本,它很长,书写的时候您想分成几行书写,但希望显示出来的效果仍然是一行,您可以使用续行符。在新的一行前面加上+=两个符号,即可实现续行。注意+=之前不应该有其它字符。从+=到您书写的第一个可显示字符之间的空白符会被忽略。在ZumDown中无需使用Markdown的换行符,直接换行即可。