mud.Ren 社区发贴排版指南

欢迎大家加入 mud.Ren 社区,本站所有内容仅围绕 mud 这个主题,可以交流分享包括MUD游戏经验、MUDLIB、LPC、MUDOS(FluffOS)的内容。请所有朋友在发贴时保证自己内容排版美观,方便阅读。

只是,当大家在发贴时是不是感觉这个编辑器LOW 爆了?NO,虽然本站倡导极简主义,但是简约而不简单。

本站使用的是 Markdown 语法排版内容,Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。

提示:如果你感觉排版标记麻烦,但至少记得段落换行,每段之间必须空一行,否则不会分段,而是自动合并为一段。如下图,为本贴内容编辑的样式: file

一、标题

在想要设置为标题的文字前面加#来表示,一个#是一级标题,二个#是二级标题,以此类推,本站支持二~六级标题,请大家发贴时最顶级的标题从二级标题开始,也就是##,因为贴子标题是一级标题,内容不支持用一级

标准语法一般在#后跟个空格再写文字。

示例:

## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

效果:

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

 二、字体

加粗

要加粗的文字左右分别用两个*号包起来

斜体

要倾斜的文字左右分别用一个*号包起来

斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

删除线

要加删除线的文字左右分别用两个~号包起来

示例:

**这是加粗的文字**
*这是倾斜的文字*
***这是斜体加粗的文字***
~~这是加删除线的文字~~

效果:

这是加粗的文字

这是倾斜的文字

这是斜体加粗的文字

这是加删除线的文字

三、引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>、三个>>>、n个...

示例:

> 这是引用的内容
>> 这是引用的内容
>>>>>>>>>> 这是引用的内容

效果:

这是引用的内容

这是引用的内容

这是引用的内容

四、分割线

三个或者三个以上的 - 或者 * 都可以。

示例:

---
----
***
*****

效果:





可以看到,显示效果是一样的。请注意 --- 一定要和上一行内容空一行,否则是把上一行内容设置为标题,在编辑时最好所有行之间都空一行。

五、图片

语法:

![图片alt](图片地址 "图片title")

图片alt就是显示在图片下面的文字,相当于对图片内容的解释,图片title是图片的标题,当鼠标移到图片上时显示的内容,title可加可不加。

示例:

![mudren](https://www.mud.ren/logo.png "mudren")

效果:

mudren

如果要上传本地图片,直接复制(或截图)粘贴到编辑区即可。

六、超链接

超连接和图片使用非常类似,只是没有!

语法:

[超链接名称](超链接地址 "超链接title")

注意:title可加可不加。

示例:

[mud.wiki](https://mud.wiki)

效果:

mud.wiki

七、列表

无序列表

无序列表用 -+* 任何一种都可以。

语法:

- 列表内容
+ 列表内容
* 列表内容

注意:- + * 跟内容之间都要有一个空格。

效果:

  • 列表内容
  • 列表内容
  • 列表内容

有序列表

语法:数字加点

1. 列表内容
2. 列表内容
3. 列表内容

注意:序号跟内容之间要有空格。

效果:

  1. 列表内容
  2. 列表内容
  3. 列表内容

列表嵌套

上一级和下一级之间敲三个空格即可,效果如下:

  • 一级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
  • 一级无序列表内容
    • 二级有序列表内容
    • 二级有序列表内容
    • 二级有序列表内容
  1. 一级有序列表内容
    1. 二级无序列表内容
    2. 二级无序列表内容
    3. 二级无序列表内容
  2. 一级有序列表内容
    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容

八、表格

语法:

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。- 有一个就行,为了对齐美观,可以多加了几个,文字默认居左,- 两边加 : 表示文字居中,- 右边加:表示文字居右

注:原生的语法两边都要用 | 包起来,但可以省略。

示例:

姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟

效果:

姓名 技能 排行
刘备 大哥
关羽 二哥
张飞 三弟

九、代码

语法:

单行代码:代码之间分别用一个反引号(ESC键下方数字1左边的那个键)包起来

`代码内容`

代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行

```
    代码...
    代码...
    代码...
```

示例:

单行代码

`create database hero;`

代码块

```
    function fun(){
         echo "这是一句非常牛逼的代码";
    }
    fun();
```

效果:

单行代码

create database hero;

代码块

    function fun(){
        echo "这是一句非常牛逼的代码";
    }
    fun();

正常情况下,内容之间不空行时会连在一起输出,如果要内容原样输入,可以让内容缩进四个空格

如果要代码语法高亮,需要在首行的三个反引号后指定代码的语言,如:

```php
/**
 * 从请求中检索输入项目.
 *
 * @param  string|null  $key
 * @param  mixed  $default
 * @return mixed
 */
public function input($key = null, $default = null)
{
    return data_get(
        $this->getInputSource()->all() + $this->query->all(), $key, $default
    );
}
```

效果如下:

/**
 * 从请求中检索输入项目.
 *
 * @param  string|null  $key
 * @param  mixed  $default
 * @return mixed
 */
public function input($key = null, $default = null)
{
    return data_get(
        $this->getInputSource()->all() + $this->query->all(), $key, $default
    );
}

本站目前没有自定义lpc语言的语法高亮,在发贴时请把LPC代码的语言指定为c,实现基本的语法高亮,后期会针对lpc语言定义语法高亮。

Markdown 不只是本站支持,简书等很多平台都支持,特别是程序员们用的最多,做为MUD开发者还是熟悉为好,更多语法说明可以看:https://guides.github.com/features/mastering-markdown/

京ICP备13031296号-4