BasicSytax.md 2.1 KB

基础语法

和Markdown类似,ZumDown的书写也是类似纯文本,如果您不需要任何额外的样式,您可以直接当做纯文本进行书写。如果您需要一些额外的样式,可以使用一些特殊的符号格式。

几个基本概念

空白符

指诸如空格、制表符等只占位置不显示内容的符号。

语法字符

用于表达ZumDown语法的符号,例如`号等。另外像#号和>号等字符出现在行首位置时是语法字符,出现在中间没有特殊意义。

可显示字符

除空白符和语法字符以外的其它符号

转义

如果您需要在文本内容中书写语法字符,您需要对其进行转义,转义使用\号,如果您需要书写\号本身,请连续输入两个。使用\号加上该语法字符,即可实现转义,即该字符会被当做可显示字符,而不被当语法字符处理。

续行符

如果您有一行文本,它很长,书写的时候您想分成几行书写,但希望显示出来的效果仍然是一行,您可以使用续行符。在新的一行前面加上+=两个符号,即可实现续行。注意+=之前不应该有其它字符。从+=到您书写的第一个可显示字符之间的空白符会被忽略。

Markdown已有的样式功能

纯文本

纯文本直接像正常那样书写就可以了。注意,与Markdown不同的是,Markdown的行尾需要两个空白符(空格等)才会换行,而在ZumDown中,你所书写的一行,就是实际上的一行,除非你使用续行符。

换行符

在ZumDown中无需使用Markdown的换行符,直接换行即可。

特殊字符自动转换

如果您需要输入的一些可显示字符,而它对于HTML来说是特殊字符,ZumDown渲染器会自动将其转换为HTML实体。 (注意同转义区分,转义是针对ZumDown语法字符,如果您输入的是ZumDown语法字符,需要手动加上转义符\,而不会自动转义) 书写时写的HTML实体本身可以被保留,例如您想插入一个版权标记 © ,输入©并在前后各留一个空白符即可。