---
description: "智能格式（⇧⌘F）：让 AI 整理笔记的 Markdown 结构 —— 只动格式，一个字都不改。"
---
<!--
  Markdown representation of https://docs.jotaid.com/zh/guide/smart-format
  Generated by scripts/gen-markdown-variants.mjs — do not edit by hand.
  Served from the canonical URL under `Accept: text/markdown`.
-->

# 智能格式

匆匆记下的东西往往结构是乱的：该是标题的行还是普通段落，粘进来的表格卡在代码块里，并列的三件事挤在一段里。**智能格式**（**⇧⌘F**）让 AI 把它整理成规整的 Markdown。

它的边界很硬：**只动格式，不动文字**。

## 怎么用

- **macOS**：**⇧⌘F**，或编辑器顶栏的 **⋯** 菜单 → 智能格式；菜单栏 **Window** 里也有
- **iOS**：笔记详情页右上的 **⋯** 菜单 → 智能格式

整理期间按钮转成加载状态。结果直接替换正文，**⌘Z** 可以撤销。

## 它会做什么

| 做什么 | 举例 |
|--------|------|
| 认出该是标题的行 | 独占一行的短句 → `## 小标题` |
| 救出被代码块困住的表格 | 粘贴时被包进围栏的表格数据 → 标准 Markdown 表格 |
| 把对齐的数据变成表格 | CSV、空格或制表符分隔的几行 → `\| 列 \| 列 \|` |
| 给并列内容加列表符号 | 连续几件平行的事 → `-` 列表 |
| 强调关键词 | 加 **粗体** 或 ==高亮== |
| 给真正的代码加代码标记 | 认出来是代码的片段 → 围栏 |
| 收拾空行与段落分隔 | 该空的空，该并的并 |

## 它不会做什么

这几条是硬约束，不是「通常不会」：

- **不增删、不修改任何文字**——它重排结构，不重写内容
- **不改变你的表达方式**——语气和用词原样保留
- **不动代码块里的程序代码**——真实代码原封不动
- **不在开头加一级 `#` 标题**——笔记标题由 Jotaid 单独管理，正文里不需要再来一个

> **它不是「清除格式」**
>
> 清除格式是**剥掉** Markdown 标记只留纯文字（工具栏最后一个按钮）；智能格式是**补上**该有的结构。两者方向相反。见[笔记格式](https://docs.jotaid.com/zh/guide/markdown-editor)。

## 两条保护

**空结果绝不写回。** 如果 AI 因为任何原因什么都没返回（接口异常、被内容审核挡下、输出被截断），Jotaid 会拒绝应用并保留原文，而不是把你的笔记清空——那种清空会经 iCloud 同步扩散到所有设备，不可逆。

**只重算改过的地方。** 再次整理同一条笔记时，Jotaid 会比对上一版，只把改动过的段落交给 AI；只有改动幅度大到接近重写时才整篇重来。这既省调用，也让没碰过的段落保持原样。

## 需要什么

智能格式是 AI 功能，需要 **Pro** 并配好自己的 **API Key**（[AI 配置](https://docs.jotaid.com/zh/guide/ai-setup)）。未配置时菜单项是灰的。

内容会发给你自己配置的服务商，不经 Jotaid 的服务器，也不用于训练。

## 别和「整理布局」搞混

同样是「整理」，管的是完全不同的东西：

| | 整理什么 | 在哪 | 用 AI |
|---|---------|------|-------|
| **智能格式** | 一条笔记的**内容结构** | 编辑器（⇧⌘F） | 是 |
| **[整理布局](https://docs.jotaid.com/zh/guide/canvas)** | 画布上**卡片的位置** | Theme 视图的浮动按钮 | 否，纯排版规则 |

## 下一步

- [笔记格式](https://docs.jotaid.com/zh/guide/markdown-editor) —— 手动格式化的工具栏与语法
- [AI 功能](https://docs.jotaid.com/zh/guide/ai-features) —— 其他 AI 能做的事
- [AI 配置](https://docs.jotaid.com/zh/guide/ai-setup) —— 配置服务商与 Key
