sub-bbs

404

找不到页面了qwq

回声岛Markdown简明教程

你现在处于访客模式
楼主 2024年6月9日 3月18日

在回声岛论坛、角色卡的补充信息、以及沙盒内的文档节点中,都需要使用到Markdown来进行排版。回声岛支持大部分常用的Markdown语法,以及一些扩展性的高级功能,鉴于大家对Markdown都不是很熟悉,本帖将直接以示例的方式来教你使用Markdown。如果你从未接触过Markdown,也无需担心,这是一种非常简单的排版方式!

总体来看,Markdown通过一系列标记来实现不同的排版效果。在展示时,回声岛会根据这些标记,将你写的Markdown内容渲染为漂亮的样式。在下面的例子中,也将会分为【如何编写】和【实际效果】来进行说明。让我们开始吧!

基本排版

如何编写
# 这是大标题
## 这是二级标题
### 这是三级标题,以此类推

## 文字样式:

Markdown 可以使用不同的字体,例如:

这是一个*斜体文本*,这是一个**粗体文本**。这是一个***粗斜体文本***。这是一个~~被删除的文本~~。而带下划线的文本比较特殊,你需要使用<u>这样的方式</u>打出来。

你可以使用`---`来打出分割线,例如:

---

## 列表:

除了文本之外,你可以像这样打出无序列表:

- 第一个项目
- 第二个项目
- 第三个项目

或者有序列表:

1. 第一个项目
2. 第二个项目
3. 第三个项目

或者二者的组合:

- 第一个项目,是一个子列表
  1. 第一个子项目,因为属于子列表,所以要在开头打两个空格来缩进。
  2. 第二个子项目
- 第二个项目
- 第三个项目

## 链接、图片、表格:

这是一个链接:[链接的名字](https://www.echois.fun)

这是一个图片:
![图片加载失败时,显示的名字](/gallery/1-white.webp)

对于表格,Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。这是一个表格:

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

## 待办列表

你可以像这样插入一个待办列表,其中,带[x]前缀的是已完成的项目:

- [ ] 项目1
- [x] 项目2
- [x] 项目3
实际效果

这是大标题

这是二级标题

这是三级标题,以此类推

文字样式:

Markdown 可以使用不同的字体,例如:

这是一个斜体文本,这是一个粗体文本。这是一个粗斜体文本。这是一个被删除的文本。而带下划线的文本比较特殊,你需要使用这样的方式打出来。

你可以使用---来打出分割线,例如:


列表:

除了文本之外,你可以像这样打出无序列表:

  • 第一个项目
  • 第二个项目
  • 第三个项目

或者有序列表:

  1. 第一个项目
  2. 第二个项目
  3. 第三个项目

或者二者的组合:

  • 第一个项目,是一个子列表
    1. 第一个子项目,因为属于子列表,所以要在开头打两个空格来缩进。
    2. 第二个子项目
  • 第二个项目
  • 第三个项目

链接、图片、表格:

这是一个链接:链接的名字

这是一个图片: 图片加载失败时,显示的名字

对于表格,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官网查看详细教程。上面的两个例子实际效果显示如下。有向图:

分支1
分支2
开始
选择
项目1
项目2
结束

时间线图:

2002事件1发生2004事件2发生事件3发生2005事件4发生2006事件5发生模组时间线梳理
编写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>

实际效果显示如下:

回声岛
跑团.com
echois.fun
0 条评论
这里什么都没有哦qwq