> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 文件格式转换

> 将 Word 文档转换为 Markdown 格式

通过将现有的 Word 文档转换为 Markdown 格式，导入到 SoloEnt 中。

## 单文件转换

将单个 `.docx` 文件转换为 Markdown：

<Steps>
  <Step title="定位文件">
    在文件管理器中找到你的 `.docx` 文件。
  </Step>

  <Step title="右键点击">
    右键点击文件打开上下文菜单。
  </Step>

  <Step title="转换">
    从菜单中选择 **"Convert to Markdown"**。
  </Step>

  <Step title="等待完成">
    文件自动转换。新的 `.md` 文件出现在同一位置。
  </Step>
</Steps>

<Info>
  原始 `.docx` 文件保持不变。转换后的 Markdown 文件作为新文件创建。
</Info>

## 批量转换

使用 "**Markdown Hub**" 插件一次转换多个 Word 文档：

<Steps>
  <Step title="安装 Markdown Hub">
    1. 点击左侧边栏的 **Extensions** 图标（第三个图标）
    2. 搜索 **"Markdown Hub"**
    3. 点击 **Install**（免费）
  </Step>

  <Step title="整理文件">
    将所有要转换的 `.docx` 文件放在同一文件夹中。
  </Step>

  <Step title="右键点击文件夹">
    右键点击包含 `.docx` 文件的文件夹。
  </Step>

  <Step title="全部转换">
    选择 **"Convert to Markdown"** 批量转换文件夹中的所有文档。
  </Step>
</Steps>

<Tip>
  使用批量转换一次导入你的整个现有作品库。
</Tip>

## 支持的格式

| 格式      | 导入 | 导出 | 说明      |
| ------- | -- | -- | ------- |
| `.docx` | ✅  | ❌  | Word 文档 |
| `.md`   | ✅  | ✅  | 原生格式    |
| `.txt`  | ✅  | ✅  | 纯文本     |
| `.pdf`  | ❌  | ✅  | 仅导出     |

<Note>
  Markdown（`.md`）是 SoloEnt 的原生格式。所有编辑功能在 Markdown 文件中效果最佳。
</Note>

## 转换质量

### 转换良好的内容

* **文本内容**：段落、标题、列表
* **基本格式**：粗体、斜体、下划线
* **结构**：章节、节、子节

### 可能需要调整的内容

* **复杂表格**：可能需要手动格式化
* **图片**：需要手动放入图片文件夹
* **自定义样式**：转换为标准 Markdown 格式
* **批注和修订记录**：不保留

<Warning>
  审查转换后的文件是否有格式问题。复杂的 Word 文档可能需要手动清理。
</Warning>

## 转换后

<Steps>
  <Step title="审查内容">
    打开转换后的 Markdown 文件，检查格式问题。
  </Step>

  <Step title="修复格式">
    调整没有干净转换的元素。
  </Step>

  <Step title="整理文件">
    将文件移动到适当的文件夹（章节、大纲等）。
  </Step>

  <Step title="开始编辑">
    开始处理你导入的内容。
  </Step>
</Steps>

<Tip>
  **让 Agent 来做：** 要求 Agent 自动处理这些任务。例如："审查转换后的文件并修复格式问题" 或 "将导入的文件整理到章节文件夹中。"
</Tip>

## 最佳实践

<AccordionGroup>
  <Accordion title="准备 Word 文档">
    * 使用标准样式（标题 1、2、3 等）
    * 避免复杂格式
    * 转换前删除不必要的样式
  </Accordion>

  <Accordion title="先用一个文件测试">
    * 转换单个文件检查质量
    * 如需要调整你的 Word 文档
    * 然后进行批量转换
  </Accordion>

  <Accordion title="备份原件">
    * 保留原始 `.docx` 文件
    * 转换前存储备份
    * 如需要随时可以重新转换
  </Accordion>
</AccordionGroup>

## 故障排除

<AccordionGroup>
  <Accordion title="转换失败">
    * 确保文件是有效的 `.docx` 格式
    * 检查文件未损坏或受密码保护
    * 尝试在 Word 中打开并重新保存
    * 作为变通方法先转换为 `.txt`
  </Accordion>

  <Accordion title="格式看起来不对">
    * 这对于复杂文档是正常的
    * 手动调整 Markdown 格式
    * 简化原始 Word 文档并重新转换
  </Accordion>

  <Accordion title="找不到转换后的文件">
    * 检查与原件相同的文件夹
    * 查找同名但扩展名为 `.md` 的文件
    * 刷新文件管理器
  </Accordion>
</AccordionGroup>

## 下一步

<CardGroup cols={2}>
  <Card title="编辑器功能" icon="pen-to-square" href="./Editor">
    学习 Markdown 编辑
  </Card>

  <Card title="组织项目" icon="folder-tree" href="./create-project">
    组织你导入的文件
  </Card>
</CardGroup>