Daily

AsmBB
登录

MiniMag 语法参考手册
0

#36 (ツ) admin
最后编辑于 05.03.26 23:37 由 admin, 浏览:10 次。

MiniMag 语法参考手册

本手册介绍 MiniMag 标记语言的核心语法。 每个语法包含:语法名称、语法说明、格式、示例。


段落

语法名称:段落

语法说明: 段落是 MiniMag 文档的基本文本单位。两个段落之间通过空行进行分隔。任何未被其他块级语法包裹的文本默认属于普通段落。

格式:

第一段文字

第二段文字
示例

这是第一段。

这是第二段。


标题

语法名称:标题

语法说明: 标题用于组织文档结构,通过在行首使用 # 符号定义。`#` 的数量表示标题级别,支持 1 到 6 级标题。

格式:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
示例

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

行内格式

语法名称:行内文字格式

语法说明: 行内格式用于对文字进行局部样式控制,如加粗、斜体、下划线等。多个格式可以嵌套组合使用。

格式:

*粗体*
/斜体/
_下划线_
-删除线-
`等宽文字`
_*/组合格式/*_
示例

粗体文字

斜体文字

下划线文字

删除线文字

等宽文字

组合格式示例


标签式链接

语法名称:标签链接

语法说明: 标签式链接允许先定义链接地址,再在正文中多次引用该标签。适用于需要重复使用同一链接的场景。

格式:

 [标签名] URL

正文中使用:

[标签名]

自定义显示文本:

[标签名][显示文字]
示例

详情请访问 AsmBB site

请访问 世界上最快的论坛


行内链接

语法名称:直接链接

语法说明: 直接链接无需预先定义标签,可在正文中直接写入 URL。也可以自定义链接显示文字。

格式:

[URL]

[URL][显示文字]
示例

访问论坛:

https://board.asm32.info

访问论坛:

世界上最快的论坛


图片

语法名称:图片

语法说明: MiniMag 支持插入图片。根据不同符号可以控制图片的显示方式,如行内图片或块级图片。

格式:

行内图片(?+url)
[?URL]

块级图片(!+url)
[!URL]
示例

行内图片:

文字开始

第一张http://bbs.icedog.top/!attached/1第二张http://bbs.icedog.top/!attached/2

文字结束

块级图片:

文字开始

第一张http://bbs.icedog.top/!attached/1第二张http://bbs.icedog.top/!attached/2

文字结束


媒体

语法名称:媒体文件

语法说明: 媒体语法用于插入视频或音频文件。具体播放方式由论坛或渲染系统实现。

格式:

[$URL]
示例

音频文件

视频文件


表情符号

语法名称:内置表情

语法说明: MiniMag 内置了一组常用表情符号,这些表情本质上是预定义的图片链接。

格式:

[?:-)]
[?:D]
[?rofl]
[?;-)]
[?:P]
[?:-(]
[?:'(]
[?>:(]
行内表情:[?:-)] [?:-)] [?:-)]

块表情:[!:-)] [!:-)] [!:-)]
示例

微笑::)

大笑::D

眨眼:;-)

自带的8个::-) :-D rofl ;-) :-P :-( :'-( >:-(

emoji 表情:😀 😁 😂 😃 😄 😅 😆 😇

行内表情::-) :-) :-)

块表情::-) :-) :-)

表情大全:

[?:-)] :-)

[?:)] :)

[?smile] smile

[?:-D] :-D

[?:D] :D

[?lol] lol

[?rofl] rofl

[?;-)] ;-)

[?;)] ;)

[?wink] wink

[?:-P] :-P

[?:P] :P

[?:-(] :-(

[?:(] :(

[?sad] sad

[?:'-(] :'-(

[?:'(] :'(

[?cry] cry

[?>:-(] >:-(

[?>:(] >:(

[?angry] angry


引用块

语法名称:引用

语法说明: 引用块用于引用其他内容或突出显示某段文本。引用块可以包含其他 MiniMag 语法元素,并支持嵌套。

格式:

;quote 引用标题
引用内容

示例:

示例引用

这是引用内容。


代码块

语法名称:代码块

语法说明: 代码块用于展示程序代码,并支持语法高亮。可指定代码语言,也可禁用高亮。

格式:

 ;begin 语言
 代码
 ;end

禁用高亮:

 ;begin nohighlight
 代码
 ;end
示例
print("Hello MiniMag")

水平分隔线

语法名称:分隔线

语法说明: 水平分隔线用于在文档中分隔不同内容区域,在行首第一列放置分号,后跟至少三个减号即可定义。

格式:

;----------------
示例

...


无序列表

语法名称:无序列表

语法说明: 无序列表用于展示一组没有顺序关系的项目。

格式:

 ;ulist
 * 项目1
 
 * 项目2
 
 * 项目3
 ;end

示例:

  • 苹果

  • 香蕉

  • 橙子


有序列表

语法名称:有序列表

语法说明: 有序列表用于展示具有顺序关系的项目,编号由系统自动生成。

格式:

 ;olist
 * 项目1
 
 * 项目2
 
 * 项目3
 ;end

示例:

  1. 第一步

  2. 第二步

  3. 第三步


嵌套列表

语法名称:嵌套列表

语法说明: 列表可以嵌套使用,用于表达层级关系。

格式:

 ;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
Attached files:
FileSizeUploadedDownloadsMD5 hash
help.png21223 bytes05.03.2026173c50f04796a4ed2f703bd088056d9df
howto3.png34805 bytes05.03.202611e0916bb42465031130fb79b5efec6e4
boom.mp34407 bytes05.03.20261bed6b55e61e43fd46883ff01923b1719
movie.mp4318465 bytes05.03.202613cf571d4cf2a4c4b2df823a27852a7d5
#38 (ツ) admin
创建于 05.03.26 23:46, 浏览:5 次。

MiniMag 语法介绍

发明者

MiniMag 语法由 Andrew Clarke 在开发论坛软件 AsmBB 时设计。

Andrew Clarke 是 AsmBB 项目的作者与主要开发者。 MiniMag 是该论坛系统默认使用的标记语言。


设计背景

在开发 AsmBB 论坛时,作者希望解决传统论坛标记语言的一些问题。 例如部分标记语言语法冗长、学习成本较高,或在论坛环境下使用不够方便。

因此作者设计了 MiniMag(Mini Markup),作为一种更加简洁、易用的轻量级标记语言。


设计目标

MiniMag 的主要设计目标包括:

  • 提供简洁直观的语法

  • 便于普通用户学习和使用

  • 便于程序解析和实现

  • 支持论坛常见内容结构


语法特点

MiniMag 采用清晰的结构化设计。 块级元素通常从行首开始,并通过统一的方式进行定义和结束。

行内格式使用简短符号表示,使文本编辑更加高效。

同时,该语法提供了对引用、列表、表格、链接、图片、媒体以及折叠内容等论坛常见元素的支持。


总结

  • MiniMag 是为论坛系统设计的一种轻量级标记语言

  • 由 Andrew Clarke 在开发 AsmBB 时创建

  • 目标是在保持语法简洁的同时提供完整的论坛文本表达能力

MiniMag 语法参考手册
0

AsmBB v3.0 (check-in: 3df85ed0b218e51a); SQLite v (check-in: 831d0fb2836b71c9);
©2016..2020 John Found; Licensed under EUPL. Powered by Assembly language Created with Fresh IDE