SmallMD4 - 山岚幽阳

## 摘要
>- SMD**是什么**？
>- **凭什么**使用SMD？
>- SMD的**语法**？
>- 旧版SMD**支持情况**？

## 正文
### 1. SMD*是什么*？
- **SmallMD**是一个==解析语言==，它以纯文本形式编写，传入SMD解析器，解析为HTML输出。
- **SmallMD**的前身是`上火shanghuo`的S1S2项目，后命名为**SnMoreDevelop语言**，最初设计与*markdown语言*无任何关系。
- **SmallMD**是自==第二版==起逐步兼容了*markdown语言*语法。
- **SmallMD**于==第三版==起不再推荐使用旧版**SnMoreDevelop语言**语法。并更名为**SmallMD**，逐步向*markdown语言*语法靠拢的。

### 2. *凭什么*使用SMD？
- 它兼容HTML，可以方便的转换为HTML格式。
- 只要你有支持HTML5的浏览器，您就可以随时使用它。
- 它也可以兼容Markdown语法。
- 方便你的排版，方便你的调用，网站开始逐步的支持它。
- 它正处在活跃的开发期，前景巨大。
- 从SMD4开始，它已经转换为了JavaScript语言，并且开源。

### 3. SMD的**语法**？
自从SMD2开始逐步兼容*markdown语言*语法，SMD的使用也变得更为简单。
当然这还不够，在未来，SMD将会以现在已支持的*markdown语言*语法为基础，不断的扩展更多更便于使用的功能。

#### 3.1 标题
1、使用`=`和`-`标记居中的一级和二级标题。
> 一级标题
> `=========`
> 二级标题
> `---------`

效果：
> 一级标题
> =========
> 二级标题
> ---------

2、使用`#`，表示默认的1-6级标题。
>\ # 一级标题
>\ ## 二级标题
>\ ### 三级标题
>\ #### 四级标题
>\ ##### 五级标题
>\ ###### 六级标题

效果：
> # 一级标题
> ## 二级标题
> ### 三级标题
> #### 四级标题
> ##### 五级标题
> ###### 六级标题

#### 3.2 引用与列表
1、引用
行开头使用符号`>`,引用是可以嵌套的，如：
>\ > 区块引用
>\ >> 嵌套引用

效果：
> 区块引用
>> 嵌套引用

2、列表
行开头使用符号`-`或`+`或`·`,列表是可以嵌套的，嵌套列表是以3个空格为一个层级进行，如下：
>\ - 列表1
>\ - 列表2
>\    - 列表21
>\    - 列表22
>\ - 列表3

效果：
- 列表1
- 列表2
   - 列表21
   - 列表22
- 列表3

3、有序的列表
列表是可以使用数字排序表示的，只要使用`1.`这样的形式即可，数字列表的起始数字由列表第一项所编写的数字确定，这意味着之后的数字无论多大，又或者打乱顺序，都不会影响编号顺序。例如：
>\ 1. 这是个有序的列表
>\ 5. 列表这里的数字是乱的
>\    3. 被嵌套的这个列表起始数字为3
>\    - 这里本应是数字，但为了方便，使用的普通列表的标记，这会得到自动修正
>\ 3. 嵌套的列表也可以无序
>\    - 列表的有序与无序，由列表相对应的第一项的标记决定（与嵌套无关）
>\    1. 这里本应使用的普通列表的标记，即使写成有序的格式，也会自动修正
>\ 5. 列表项

效果：
1. 这是个有序的列表
5. 列表这里的数字是乱的
   3. 被嵌套的这个列表起始数字为3
   - 这里本应是数字，但为了方便，使用的普通列表的标记，这会得到自动修正
3. 嵌套的列表也可以无序
   - 列表的有序与无序，由列表相对应的第一项的标记决定（与嵌套无关）
   1. 这里本应使用的普通列表的标记，即使写成有序的格式，也会自动修正
5. 列表项

#### 3.3 代码块
代码块在单独行用`\`\`\``标记。如:
>\ \`\`\`
>\#include <stdio.h>
>\int main(){
>\    printf("Hi, SMD.");
>\    return 0;
>\}
>\ \`\`\`

效果：
```
#include <stdio.h>
int main(){
    printf("Hi, SMD.");
    return 0;
}
```

#### 3.4 事项
在相应行开头使用“-”后跟一个空格，再跟“[”后跟**“x”或一个空格**“]”后跟一个空格，可与同类行开头标记配合使用(如:引用)，事项默认不会自行换行：
>\ - [ ] 未办事项
>\ - [x] 已办事项
>\ > - [ ] 引用内容与未办事项配合

效果：
- [ ] 未办事项
- [x] 已办事项
> - [ ] 引用内容与未办事项配合

#### 3.5 分割线
需要在新行，且`---`时上一行只能为空字符或`*`与`-`，但连续两行`-`只解析一行为hr，同时`---`或`***`前后不能含有任何字符，除了换行，`-`数量必须3个以上):
>\ ***
>\ ---

效果：
***
---

#### 3.6 表格
表格应至少含有一行表头，一行表格标记，一行内容，如下即为一个最小的2×2表格：
> 表格|表头
>\ ---|---
> 表格|内容

表格的描述可以有以下几种：将列居中对齐`:---:`，将列右对齐`---:`，将列当作表头`===`，默认左对齐`---`或`:---`。这里的`-`在开头两列至少应有3个，之后每列没有强制要求，当作表头即将这里的`-`改为`=`，当作表头后用于标记对齐方式的`:`将会被忽略。
表格可以被嵌套在引用等中，这只要把表格的前两行（也就是表头和描述表格格式的那两行)，的之前加入引用等的标识即可，标识与表格描述间应避免存在空格或其它字符。表格允许是异形的，未在描述中声明的列将被默认对齐。具体如下
>\>表格示例|默认对齐|居中对齐|左对齐|右对齐|表头
>\`>========|--------|:------:|:-----|-----:|----`
> 表头列|内容|内容|内容|内容|内容
> 表格|内容|内容|内容|内容|内容|未声明列默认对齐
> 表格|内容|内容|内容|内容|内容|表格异形部分
> 表格|内容|内容|内容|内容|内容

效果：
>表格示例|默认对齐|居中对齐|左对齐|右对齐|表头
>========|--------|:------:|:-----|-----:|----
表头列|内容|内容|内容|内容|内容
表格|内容|内容|内容|内容|内容|未声明列默认对齐
表格|内容|内容|内容|内容|内容|表格异形部分
表格|内容|内容|内容|内容|内容

#### 3.7 链接
链接的格式为：
`[链接内容](链接地址)`或
`[链接内容](链接地址"链接内容")`或
`[链接说明]:链接地址"链接内容"`或
`[链接内容][链接说明](链接地址)`这4种形式
效果：
> 链接是行内标签，[这就是个链接](#"这是链接内容，链接地址为#号")，链接前后可以存在内容

#### 3.8 图片
图片的格式为：
`![图片说明](图片地址)`或
`[图片说明](图片地址)"图片长:图片宽"`这2种形式
效果：
> 图片是行内标签，[这里的地址用的base64表示，但通常应使用URL表示](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUAQMAAAC3R49OAAAAA1BMVEWKqIm5Yq7pAAAADElEQVQImWNgoC4AAABQAAGmLdqcAAAAAElFTkSuQmCC)"50:100"，图片前后可以存在内容

#### 3.9 文本样式
标记:`\`内容\``，前后分别1个`\``，通常用于标出指数，这个符号一般位于键盘左上角数字1左侧，通常标记中的内容不会再存在其它样式
删除线:`~~内容~~`，前后分别2个`~`,这个符号一般位于键盘左上角数字1左侧
下划线:`++内容++`
上标字:`^^内容^^`，前后分别1或2个`^`，通常用于标出指数，`^`一般位于英文模式下的键盘数字6上
下标字:`^^^内容^^^`，前后分别3个`^`，也就和上标字相反了
高亮:`==内容==`
强调:`!!内容!!`
倾斜并加粗:`***内容***`或`___内容___`，多个`*或_`混合时将按照单个优先原则执行倾斜并加粗
加粗:`**内容**`或`__内容__`
倾斜:`*内容*`或`_内容_`

效果：
正常文本 ***倾斜并加粗*** **加粗** *倾斜* `标记` ~~删除线~~ ++下划线++ ^^上标字^^ ^^^下标字^^^ ==高亮== !!强调!!

#### 3.10 关于转义等
对于行开头的情况，在遇到第一个`\ `后，这个反斜杠会被清理，之后的标识被当作内容处理。
标识之后不会对是否存在空格进行检查，行开头的转义如果之后有空格，应加在空格之前，而非紧跟期望转义的项。

对于行内的情况，除了标记使用的`\``需要反斜杠转义，其它的内容应当使用标记包含起来实现。
需要注意的是`\``和`\ \``前的第一个空格会被消除，这样也就便于你对下面特殊情况做描述。如下表：
需要描述内容|写法|说明
------------|----|---
`<`(内容中)|`&lt;`|内容中，使用HTML的实体来描述尖括号
`>`(行开头)|`\>`|行开头遇到转义符号后，之后内容均为文本
`  内容`(行开头)|`\  内容`|一般的行开头要保留空格，应在要保留的空格前加转义符
`\``|`\\``|转义符号转义`\``
`\\``|`\\\``|最后一个反斜杠将用于转义，其它不影响
`\\ `|`\\  `|内容后跟一个空格，空格会被消除
`\\  `|`\\   `|内容后跟两个或多个空格，最后一个空格会被消除，其它不影响
`\``(位于行开头)|`\\\``|行开头需要得到`\``应当先用一个`\ `把行开头进行清理，然后再写`\\``
`\ `(位于结尾)|`\ `|结尾和内容中的反斜杠，都直接书写即可，不受转义影响

### 4 旧版SMD**支持情况**？
旧版相关的内容，已改为添加到了代码块的解析功能中，加入后你可以在代码块开头的`\`\`\``的后面加入`SMD1&2`，然后在代码框的范围内使用旧版功能.
旧版功能已被淘汰，但仍然被兼容。旧版样式设置相关代码已被移除，SMD3版本起，已一律由页面使用样式表决定。下面引用框中是使用旧版解析的一组例子：
>```SMD1&2
#1SMD1功能
#2旧版代码框
p-
int main(){
   return 0;
}
-p
#2旧版块元素
bb
这是一个块
cc
#2旧版标题
l1靠左一号标题
l2靠左二号标题
l3靠左三号标题
l4靠左四号标题
l5靠左五号标题
l6靠左六号标题
c1居中一号标题
c2居中二号标题
c3居中三号标题
c4居中四号标题
c5居中五号标题
c6居中六号标题
r1靠右一号标题
r2靠右二号标题
r3靠右三号标题
r4靠右四号标题
r5靠右五号标题
r6靠右六号标题
#1自动一号标题
#2自动二号标题
#3自动三号标题
#4自动四号标题
#5自动五号标题
#6自动六号标题
#2旧版分割线
-|
这是分割线
hr
#2旧版换行
-=换行
br
#2旧版引用
yy引用的内容
>-引用的内容
#2旧版链接与图片
a-我是一个链接,,#
i-data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUAQMAAAC3R49OAAAAA1BMVEWKqIm5Yq7pAAAADElEQVQImWNgoC4AAABQAAGmLdqcAAAAAElFTkSuQmCC
iadata:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUAQMAAAC3R49OAAAAA1BMVEWKqIm5Yq7pAAAADElEQVQImWNgoC4AAABQAAGmLdqcAAAAAElFTkSuQmCC,,#
#2旧版转换与直接输出
转换输出
-=
zhprintf("hello");
-=
直接输出
-=
zzprintf("hello");
#1SMD2功能
#2旧版行内元素
行内元素
x-
实质看不出
-x
会有什么变化
#2旧版列表和表格
旧版的列表与表格已不再提供支持，现在以换行的形式输出
u=列表已不再提供支持
u=列表已不再提供支持
-=
t-表格,,表格,,表格
t-不再,,提供,,支持
t-表,,格,,不再提供支持
#1SMD3功能
#2旧版段落
p=
这是一段文本
-=这段文本换行了
=p
p=
这是另一段文本
-=这段文本也换行了
=p
#2旧版可换行等的引用
b-
这是引用中的内容
-=这个引用可以换行
-b
#2旧版代码标记
c-
这是一个标记
-c
```
以上就是现目前旧版的兼容解析的一个例子，现已不推荐使用，但你确实需要使用，也不用担心我们未来会删除的可能性，我们只是不会再对旧版解析进行维护，但我们依旧会保留这些非常烂功能。

### 感谢与支持
首先要感谢`fmq03`在很早以前的SMD1编写期间的协助测试。
同时还要感谢`MFC.jar`在SMD4编写时提出的非常不错的建议。
SMD4在经过`上火`（`shanghuo`）3天的设计与编写，现在已经基本完成。
未来我们还将计划加入曾经`S1S2`等程序设计中，优质的部分，以及我们计划中的一些高级的功能。
如果你想支持我们，我们的网站[www.snang.cc](http://www.snang.cc)随时欢迎您的到来。
by 山岚幽阳

2019-01-21 08:56:07