回声岛Markdown简明教程
在回声岛论坛、角色卡的补充信息、以及沙盒内的文档节点中,都需要使用到Markdown来进行排版。回声岛支持大部分常用的Markdown语法,以及一些扩展性的高级功能,鉴于大家对Markdown都不是很熟悉,本帖将直接以示例的方式来教你使用Markdown。如果你从未接触过Markdown,也无需担心,这是一种非常简单的排版方式!
总体来看,Markdown通过一系列标记来实现不同的排版效果。在展示时,回声岛会根据这些标记,将你写的Markdown内容渲染为漂亮的样式。在下面的例子中,也将会分为【如何编写】和【实际效果】来进行说明。让我们开始吧!
基本排版
如何编写
# 这是大标题
## 这是二级标题
### 这是三级标题,以此类推
## 文字样式:
Markdown 可以使用不同的字体,例如:
这是一个*斜体文本*,这是一个**粗体文本**。这是一个***粗斜体文本***。这是一个~~被删除的文本~~。而带下划线的文本比较特殊,你需要使用<u>这样的方式</u>打出来。
你可以使用`---`来打出分割线,例如:
---
## 列表:
除了文本之外,你可以像这样打出无序列表:
- 第一个项目
- 第二个项目
- 第三个项目
或者有序列表:
1. 第一个项目
2. 第二个项目
3. 第三个项目
或者二者的组合:
- 第一个项目,是一个子列表
1. 第一个子项目,因为属于子列表,所以要在开头打两个空格来缩进。
2. 第二个子项目
- 第二个项目
- 第三个项目
## 链接、图片、表格:
这是一个链接:[链接的名字](https://www.echois.fun)
这是一个图片:

对于表格,Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。这是一个表格:
| 表头 | 表头 |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
## 待办列表
你可以像这样插入一个待办列表,其中,带[x]前缀的是已完成的项目:
- [ ] 项目1
- [x] 项目2
- [x] 项目3
实际效果
这是大标题
这是二级标题
这是三级标题,以此类推
文字样式:
Markdown 可以使用不同的字体,例如:
这是一个斜体文本,这是一个粗体文本。这是一个粗斜体文本。这是一个被删除的文本。而带下划线的文本比较特殊,你需要使用这样的方式打出来。
你可以使用---
来打出分割线,例如:
列表:
除了文本之外,你可以像这样打出无序列表:
- 第一个项目
- 第二个项目
- 第三个项目
或者有序列表:
- 第一个项目
- 第二个项目
- 第三个项目
或者二者的组合:
- 第一个项目,是一个子列表
- 第一个子项目,因为属于子列表,所以要在开头打两个空格来缩进。
- 第二个子项目
- 第二个项目
- 第三个项目
链接、图片、表格:
这是一个链接:链接的名字
这是一个图片:
对于表格,Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。这是一个表格:
表头 | 表头 |
---|---|
单元格 | 单元格 |
单元格 | 单元格 |
待办列表
你可以像这样插入一个待办列表,其中,带[x]前缀的是已完成的项目:
- 项目1
- 项目2
- 项目3
折叠块
就像你正在看的这个帖子一样,你可以像这样插入一个折叠块。
+++ 标题
内容
+++
实际效果如下:
标题
内容
内容居中
你可以使用:
:::center
你的内容
:::
来让内容居中显示
插入B站视频
如何编写
你可以像这样插入B站视频,请根据需要改变BV号:
@[bilibili](BV16741187v6)
实际效果
插入PDF
如何编写
你可以像这样插入PDF,请根据需要改变圆括号中的pdf文件链接:
@[pdf](https://arxiv.org/pdf/1512.03385)
由于pdf需要调用外部链接,因此目标链接的可使用性、以及你使用的浏览器都会影响最终的显示效果。
实际效果
进阶使用
绘制图表
你甚至可以绘制图表!使用Mermaid,你可以绘制出流程图、关系图等复杂图形。例如:
这是一个有向图:
```mermaid
flowchart LR
A[开始] --> B{选择}
B -->|分支1| C[项目1]
C --> D[项目2]
D --> B
B ---->|分支2| E[结束]
```(注意开头和结尾的```符号不能丢)
这是一个时间线图:
```mermaid
timeline
title 模组时间线梳理
2002 : 事件1发生
2004 : 事件2发生
: 事件3发生
2005 : 事件4发生
2006 : 事件5发生
```(注意开头和结尾的```符号不能丢)
想要学习更多图表,请前往Mermaid官网查看详细教程。上面的两个例子实际效果显示如下。有向图:
时间线图:
编写HTML
实际上,Markdown本身会被渲染为HTML节点,因此,你可以直接在编辑器中编写简单的HTML代码。如果你不懂HTML,可以先 看看这个教程,只关注其中对HTML结构的介绍即可。在回声岛的Markdown编辑器中,你只需要用到class
属性,使用Tailwind class 来实现各种效果。
唯一要注意的事情是,使用HTML时,代码内部不能有空行。
一个简单的例子:
<div class="flex font-bold rounded-md overflow-hidden w-max text-white">
<div class="p-2 bg-red">回声岛</div>
<div class="p-2 bg-purple">跑团.com</div>
<div class="p-2 bg-blue">echois.fun</div>
</div>
实际效果显示如下: