MiniMag 语法参考手册
本手册介绍 MiniMag 标记语言的核心语法。 每个语法包含:语法名称、语法说明、格式、示例。
段落
语法名称:段落
语法说明: 段落是 MiniMag 文档的基本文本单位。两个段落之间通过空行进行分隔。任何未被其他块级语法包裹的文本默认属于普通段落。
格式:
第一段文字
第二段文字
示例 这是第一段。
这是第二段。
标题
语法名称:标题
语法说明:
标题用于组织文档结构,通过在行首使用 # 符号定义。`#` 的数量表示标题级别,支持 1 到 6 级标题。
格式:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
示例 一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
行内格式
语法名称:行内文字格式
语法说明: 行内格式用于对文字进行局部样式控制,如加粗、斜体、下划线等。多个格式可以嵌套组合使用。
格式:
*粗体*
/斜体/
_下划线_
-删除线-
`等宽文字`
_*/组合格式/*_
示例 粗体文字
斜体文字
下划线文字
删除线文字
等宽文字组合格式示例
标签式链接
语法名称:标签链接
语法说明: 标签式链接允许先定义链接地址,再在正文中多次引用该标签。适用于需要重复使用同一链接的场景。
格式:
[标签名] URL
正文中使用:
[标签名]
自定义显示文本:
[标签名][显示文字]
示例 详情请访问 AsmBB site。
请访问 世界上最快的论坛。
行内链接
语法名称:直接链接
语法说明: 直接链接无需预先定义标签,可在正文中直接写入 URL。也可以自定义链接显示文字。
格式:
[URL]
[URL][显示文字]
示例 访问论坛:
访问论坛:
图片
语法名称:图片
语法说明: MiniMag 支持插入图片。根据不同符号可以控制图片的显示方式,如行内图片或块级图片。
格式:
行内图片(?+url)
[?URL]
块级图片(!+url)
[!URL]
示例 行内图片:
文字开始
第一张
第二张
![]()
文字结束
块级图片:
文字开始
第一张
第二张
![]()
文字结束
媒体
语法名称:媒体文件
语法说明: 媒体语法用于插入视频或音频文件。具体播放方式由论坛或渲染系统实现。
格式:
[$URL]
示例 音频文件
视频文件
表情符号
语法名称:内置表情
语法说明: MiniMag 内置了一组常用表情符号,这些表情本质上是预定义的图片链接。
格式:
[?:-)]
[?:D]
[?rofl]
[?;-)]
[?:P]
[?:-(]
[?:'(]
[?>:(]
行内表情:[?:-)] [?:-)] [?:-)]
块表情:[!:-)] [!:-)] [!:-)]
示例 微笑:
![]()
大笑:
![]()
眨眼:
![]()
自带的8个:
![]()
![]()
![]()
![]()
![]()
![]()
![]()
![]()
emoji 表情:😀 😁 😂 😃 😄 😅 😆 😇
行内表情:
![]()
![]()
![]()
块表情:
![]()
![]()
![]()
表情大全:
[?:-)]![]()
[?:)]![]()
[?smile]![]()
[?:-D]![]()
[?:D]![]()
[?lol]![]()
[?rofl]![]()
[?;-)]![]()
[?;)]![]()
[?wink]![]()
[?:-P]![]()
[?:P]![]()
[?:-(]![]()
[?:(]![]()
[?sad]![]()
[?:'-(]![]()
[?:'(]![]()
[?cry]![]()
[?>:-(]![]()
[?>:(]![]()
[?angry]![]()
引用块
语法名称:引用
语法说明: 引用块用于引用其他内容或突出显示某段文本。引用块可以包含其他 MiniMag 语法元素,并支持嵌套。
格式:
;quote 引用标题
引用内容
示例:
示例引用 这是引用内容。
代码块
语法名称:代码块
语法说明: 代码块用于展示程序代码,并支持语法高亮。可指定代码语言,也可禁用高亮。
格式:
;begin 语言
代码
;end
禁用高亮:
;begin nohighlight
代码
;end
示例 print("Hello MiniMag")
水平分隔线
语法名称:分隔线
语法说明: 水平分隔线用于在文档中分隔不同内容区域,在行首第一列放置分号,后跟至少三个减号即可定义。
格式:
;----------------
示例 ...
无序列表
语法名称:无序列表
语法说明: 无序列表用于展示一组没有顺序关系的项目。
格式:
;ulist
* 项目1
* 项目2
* 项目3
;end
示例:
苹果
香蕉
橙子
有序列表
语法名称:有序列表
语法说明: 有序列表用于展示具有顺序关系的项目,编号由系统自动生成。
格式:
;olist
* 项目1
* 项目2
* 项目3
;end
示例:
第一步
第二步
第三步
嵌套列表
语法名称:嵌套列表
语法说明: 列表可以嵌套使用,用于表达层级关系。
格式:
;ulist
* 一级项目
;ulist
* 二级项目
* 二级项目
;end
* 一级项目
;end
示例:
编程语言
C
Python
数据库
MySQL
SQLite
折叠内容
语法名称:折叠块(Spoiler)
语法说明: 折叠块用于隐藏内容,读者需要点击展开才能查看。
格式:
;spoiler 标题
折叠内容
;end
示例:
点击展开
这是隐藏内容。
表格
语法名称:表格
语法说明:
表格用于展示结构化数据。每个段落对应一个单元格,使用 ;----------------- 分隔行。
格式:
;table
# 表头1
# 表头2
# 表头3
;-----------------
单元格
单元格
单元格
;end
示例:
名称 |
类型 |
描述 |
|---|---|---|
MiniMag |
标记语言 |
论坛文本格式 |
AsmBB |
论坛软件 |
支持 MiniMag |
语法嵌套规则
语法名称:语法嵌套规则
语法说明: MiniMag 的大多数块级语法允许嵌套,但代码块内部不会解析其他语法。
格式:
;quote 示例
;ulist
* 项目
* 项目
;end
;end
示例:
;quote 示例
;ulist
* 列表项
* 列表项
;end
;end