---
description: "在 Jotaid 里写 Markdown 表格：编辑器就地渲染，光标进入即变回源码，点击可全宽查看。"
---
<!--
  Markdown representation of https://docs.jotaid.com/zh/guide/insert-tables
  Generated by scripts/gen-markdown-variants.mjs — do not edit by hand.
  Served from the canonical URL under `Accept: text/markdown`.
-->

# 插入表格

## 写法

用竖线分列，第二行是分隔行：

```markdown
| 方案 | 成本 | 风险 |
|------|------|------|
| A    | 低   | 中   |
| B    | 高   | 低   |
```

分隔行里加冒号可以定对齐：`:---` 左对齐、`:---:` 居中、`---:` 右对齐。列宽不必对齐，渲染时会自己算。

## 两种样子

表格是编辑器里少数**就地渲染**的块之一，它有两种状态，切换是自动的：

| 状态 | 什么时候 | 看到什么 |
|------|---------|---------|
| **渲染** | 光标不在表格里 | 画好线的表格 |
| **源码** | 光标落进表格范围 | 原始的 `\|` 行，可以直接改 |

也就是说：读的时候是表格，改的时候是源码，不需要你切换任何模式。改完把光标移走，它立刻变回表格。

> **表格太宽？**
>
> 点一下渲染后的表格，Jotaid 会用一个可以横向滚动的面板打开它，宽表格不必挤在编辑器的宽度里读。这个面板是只读的——要改还是回到正文里改。

在**预览**（⌃⇧P）里，表格按主题样式完整渲染，超宽时同样可以横向滚动。

## 什么时候不该用表格

表格适合**同一批对象的同一批属性**（方案比成本、模型比价格）。如果你发现自己在表格里塞一整段论述，那更适合小标题加正文；如果你在用表格给条目排序，[列表](https://docs.jotaid.com/zh/guide/insert-lists)更轻。

## 下一步

- [插入公式](https://docs.jotaid.com/zh/guide/insert-math) —— 另一种在编辑器里渲染的块
- [插入代码](https://docs.jotaid.com/zh/guide/insert-code) —— 围栏代码块与 Mermaid 图