> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 代码

> 在文档中添加带语法高亮和格式选项的代码块。

Craft 的代码编辑器让你可以在文档中直接创建、编辑并展示代码。它支持 30 多种编程语言，为大多数语言提供语法高亮，并为技术写作与文档提供清爽且可靠的体验。

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/write-and-edit/code/en/content/code-editor-overview.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=3917ee7a689ab58b810fe902536a91d4" alt="Code editor overview" width="957" height="824" data-path="images/write-and-edit/code/en/content/code-editor-overview.png" />

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/write-and-edit/code/en/content/code-editor-fullscreen.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=458581dfeb0edfd991c68d1c73e80f98" alt="Code editor fullscreen mode" width="999" height="881" data-path="images/write-and-edit/code/en/content/code-editor-fullscreen.png" />

## 插入代码块

在文档中的任意位置使用以下方法插入代码块：

* 输入 `/code` 并选择 Insert Code Block
* 在右侧 sidebar 的 Insert 菜单中选择 Code Block
* 输入三个反引号 ` ``` ` 来插入代码块

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/write-and-edit/code/en/content/insert-code-block.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=487f2ed842a6c236003b0d02fcd4b9a2" alt="Inserting a code block" width="1256" height="1101" data-path="images/write-and-edit/code/en/content/insert-code-block.png" />

## 更改语言

为获得正确的语法高亮，请设置编程语言：

<Steps>
  <Step>
    点击位于块右上角的 three-dot menu (⋯)。
  </Step>

  <Step>
    点击 Select Language（编码图标）。
  </Step>

  <Step>
    从列表中选择另一种语言。
  </Step>

  <Step>
    对受支持的语言，语法高亮会立即更新。
  </Step>
</Steps>

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/write-and-edit/code/en/content/select-language.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=8d145448ae29857836217cf627895393" alt="Selecting a programming language" width="999" height="881" data-path="images/write-and-edit/code/en/content/select-language.png" />

## 自定义主题

更改代码块的视觉外观：

<Steps>
  <Step>
    点击位于块右上角的 three-dot menu (⋯)。
  </Step>

  <Step>
    点击 Select Theme（画笔图标）。
  </Step>

  <Step>
    从列表中选择你喜欢的主题。
  </Step>
</Steps>

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/write-and-edit/code/en/content/select-theme.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=371bb814edd2b827a47e4f7ed5a19622" alt="Selecting a code theme" width="999" height="881" data-path="images/write-and-edit/code/en/content/select-theme.png" />

## 主要功能

Craft 更新后的代码编辑器包含多项改进：

* **Craft AI 助手集成** – 可在文档中直接让 AI 帮你处理代码
* **全屏模式** – 专注编码，无干扰
* **没有字符限制** – 长代码示例完全支持
* **自动换行** – 提高长行可读性
* **稳定性提升** – 已解决代码块消失等历史问题
* **干净且重新设计的全屏模式** – 在 macOS 上有更佳体验

这些改进让编写与维护技术内容更顺畅、更可预期。

## 限制

代码编辑器仍在不断演进，请注意以下行为：

* **数学公式**：无法通过语言选择器将代码块转换为数学公式。数学公式必须显式使用 `/menu → Insert TeX formula` 或通过 Insert sidebar 插入。
* **固定高度**：文档视图中的代码块具有固定高度且不滚动。这可以避免页面滚动与块内滚动之间的冲突。
* **以下语言不支持语法高亮**：Ada、Dart、Haskell、Julia、Matlab、Objective-C、Perl、Prolog、Scala、VB.NET
* **没有自动补全**：代码自动补全特性（例如自动补全闭合标签）不受支持，因为这些功能不属于 Runestone – 我们代码编辑器的基础。
* **旧设备上的性能**：如果在同一页面添加很多代码块，性能在较弱设备上可能会受到影响，尽管总体性能已显著改善。
* **拼写检查**：拼写检查由 Safari 或系统设置控制，而非 Craft。

<Info title="AI 助手">
  Craft 的 AI 助手可以直接在你的代码块中工作，帮助你调试、解释或重构代码，无需离开文档。
</Info>