> ## 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 檔案與其相關的媒體檔案（圖片、附件）打包成單一 bundle。這讓在應用程式之間移動文件時，不會遺失嵌入內容或遇到破損的圖片連結。

**主要功能：**

* 以 Markdown 為基礎的內容並包含 metadata
* 嵌入的圖片與附件隨檔案一併保留
* 保留文件結構與格式
* 被多種筆記應用廣泛支援

## 匯入 TextBundle 檔案

<Tabs>
  <Tab title="macOS & iOS">
    <Steps>
      <Step>
        打開 Craft，前往 **所有文件**、**整理** 或 **未分類** 檢視
      </Step>

      <Step>
        點擊右上角的 **three-dot menu (⋯)**
      </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 區塊
* **標題與結構** – 文件層級維持不變
* **圖片** – 嵌入的圖片會出現在正確位置
* **附件** – 包含在 bundle 中的檔案會被匯入
* **連結** – 內部與外部連結皆會保留

## 匯入限制

為確保穩定效能，Craft 對匯入設定了下列限制：

* **每次匯入最多 1,000 個檔案**
* **大型 bundle 檔案** 可能需要更長處理時間
* **不支援的 Markdown 功能** 可能無法完全轉換

<Info title="批次匯入">
  如果你需要匯入超過 1,000 個檔案，請將檔案分成較小的批次分別匯入。
</Info>

## 匯入後

匯入後，你的 TextBundle 內容會成為 Craft 的原生文件。你可以：

* 使用 Craft 的完整功能編輯和格式化
* 新增區塊、頁面與媒體
* 將文件整理到資料夾與集合中
* 分享或發佈你的文件

## 相關主題

<CardGroup cols={2}>
  <Card title="匯入總覽" href="/zh-Hant/import-and-export/import">
    瞭解 Craft 中所有的匯入選項
  </Card>

  <Card title="匯出選項" href="/zh-Hant/import-and-export/export">
    瞭解如何匯出你的 Craft 文件
  </Card>
</CardGroup>
