RikkaHub 完整 Markdown 渲染 · 代码高亮 LaTeX Mermaid
RikkaHub 渲染什么
RikkaHub 为助手消息（以及部分用户消息）渲染以下富文本元素：
| 元素 | 说明 | 原生支持 |
|---|---|---|
| 代码块 | 围栏代码块带语法高亮 | ✅ |
| LaTeX 公式 | $行内$ 和 $$块级$$ | ✅ |
| Mermaid 图表 | ```mermaid 代码块渲染为可交互图表 | ✅ |
| Markdown 表格 | 标准表格，窄屏横向滚动 | ✅ |
| 标准 Markdown | 加粗、斜体、链接、列表、引用、分隔线 | ✅ |
代码块
使用围栏代码块（三反引号）并指定语言，会自动语法高亮：
def hello(name): print(f"Hello, {name}!")
支持的语言取决于内置语法高亮器，常见的 Python / JavaScript / TypeScript / Java / C++ / Go / Rust / SQL / HTML / CSS 等都支持。
代码块的操作
- 复制：点击代码块右上角的复制图标，一键复制内容到剪贴板
- 显示行号：设置 → 偏好设置 → 显示 → 代码块 → 显示行号
- 自动换行：设置 → 偏好设置 → 显示 → 代码块 → 自动换行（长行不滚动）
- 自动折叠：设置 → 偏好设置 → 显示 → 代码块 → 自动折叠（超长代码默认收起）
LaTeX 数学公式
- 行内公式：
$E = mc^2$→ 在一行内渲染 - 块级公式：
$$\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}$$→ 单独居中块级
禁用 LaTeX
如果你不常用数学公式，可以在 设置 → 偏好设置 → 显示 → LaTeX 渲染 里关闭。关闭后 $...$ 不会被渲染，会原样显示。
Mermaid 图表
graph TD A[开始] --> B{判断} B -->|是| C[继续] B -->|否| D[结束]
渲染为可交互的流程图。点击图表上的导出按钮可以保存为图片。
常见 Mermaid 图表类型
graph TD流程图sequenceDiagram时序图classDiagram类图stateDiagram-v2状态图erDiagramER 图gantt甘特图pie饼图
Markdown 表格
| 项目 | 说明 | 状态 |
|---|---|---|
| 代码高亮 | 带颜色语法 | ✅ |
| LaTeX | 数学公式 | ✅ |
| Mermaid | 流程图 | ✅ |表格会自动对齐列宽。窄屏设备上可以横向滚动查看宽表格。
v2.5.6 新增：图表工具
v2.5.6 新增了图表工具——AI 可以在聊天中直接展示折线图、柱状图和散点图。这不是 Mermaid，是 RikkaHub 提供的原生图表渲染能力。AI 生成的数据直接以图表形式展示，而不是纯文本表格。
用户消息也能渲染吗
默认情况下，RikkaHub 对助手消息渲染富文本，但用户消息通常只渲染基础 Markdown（加粗、斜体）。这取决于助手设置里的正则转换器和显示选项。
常见问题
LaTeX 公式没有渲染
- 检查格式：行内
$...$、块级$$...$$ - 检查是否在设置里禁用了 LaTeX 渲染
- 某些模型可能会输出不完整的 LaTeX（比如丢了右
$），手动补上
Mermaid 渲染报错
- 检查 Mermaid 代码语法（Mermaid 对语法敏感）
- 把模型输出的 ``
mermaid ...`` 代码块复制到 Mermaid 在线编辑器验证 - 格式正确但还是报错 → 可能是 RikkaHub 内 Mermaid 版本较旧，等版本更新