> ## 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.

# TextBundle

> 将 TextBundle 和 TextPack 文件导入 Craft，并保留图片和附件。

TextBundle 是一种开源文件格式，旨在让包含嵌入图片和附件的文本文档在不同应用间更易携带与使用。Craft 支持导入 TextBundle (`.textbundle`) 和 TextPack (`.textpack`) 文件，并保留你的内容结构、格式和媒体。

## 什么是 TextBundle？

TextBundle 会将一个 Markdown 文件及其关联的媒体文件（图片、附件）打包成一个单一的文件包。这让在应用之间移动文档时，不会丢失嵌入内容或遇到损坏的图片链接。

**主要特性**

* 基于 Markdown 的内容并包含元数据
* 嵌入的图片和附件保持在一起
* 保留文档结构和格式
* 在多种笔记应用中广泛受支持

## 导入 TextBundle 文件

<Tabs>
  <Tab title="macOS & iOS">
    <Steps>
      <Step>
        打开 Craft，进入 **所有文档**、**整理** 或 **未分类** 视图
      </Step>

      <Step>
        点击右上角的三点菜单
      </Step>

      <Step>
        在“导入 / 导出”部分选择 **导入**
      </Step>

      <Step>
        选择你的 TextBundle 或 TextPack 文件
      </Step>
    </Steps>

    <img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/import-and-export/import/textbundle/en/content/import-menu.png?fit=max&auto=format&n=bXGV3J9qfsAQZqJz&q=85&s=c97b316deb97f685d8bc0d6e9524758c" alt="显示导入选项的导入菜单" width="1303" height="849" data-path="images/import-and-export/import/textbundle/en/content/import-menu.png" />

    Craft 会创建一个包含你内容的新文档，所有嵌入的图片和附件会保留在文本的原始位置。
  </Tab>

  <Tab title="Web">
    <Warning title="Web 限制">
      Web 应用目前仅支持导入单个 Markdown 文件，Web 版本不支持导入 TextBundle。请使用桌面或移动应用导入 TextBundle 文件。
    </Warning>
  </Tab>
</Tabs>

## 会导入哪些内容

导入 TextBundle 文件时，Craft 会保留：

* **文本内容** - 所有 Markdown 格式会转换为 Craft 块
* **标题和结构** - 文档层级会被保留
* **图片** - 嵌入的图片会出现在正确位置
* **附件** - 打包中的文件会被导入
* **链接** - 内部和外部链接均会保留

## 导入限制

为确保稳定性能，Craft 对导入设置了以下限制：

* 每次导入最多 1,000 个文件
* 体积较大的包处理时间可能更长
* 不受支持的 Markdown 功能可能无法完全转换

<Info title="批量导入">
  如果需要导入超过 1,000 个文件，请将它们分成更小的批次分别导入。
</Info>

## 导入后

导入后，你的 TextBundle 内容会成为 Craft 原生文档。你可以：

* 使用 Craft 的全部功能进行编辑和格式化
* 添加新的块、页面和媒体
* 整理到文件夹和集合中
* 共享或发布你的文档

## 相关主题

<CardGroup cols={2}>
  <Card title="导入概览" href="/zh-Hans/import-and-export/import">
    了解 Craft 中的所有导入选项
  </Card>

  <Card title="导出选项" href="/zh-Hans/import-and-export/export">
    了解如何导出你的 Craft 文档
  </Card>
</CardGroup>