> ## 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 文档无法转换或显示错误。

**解决方案：**

* 确保文件是有效的 `.docx` 格式（不是 `.doc` 或其他格式）
* 检查文件未损坏或受密码保护
* 尝试在 Microsoft Word 中打开并重新保存
* 转换前移除密码保护
* 作为变通方法先转换为 `.txt`
* 检查文件大小（非常大的文件可能会失败）

## 格式看起来不对

**问题：** 转换后的 Markdown 有格式问题。

**解决方案：**

* 这对于具有高级格式的复杂 Word 文档是正常的
* 使用编辑器手动调整 Markdown 格式
* 简化原始 Word 文档（删除复杂样式、表格等）
* 简化后重新转换
* 对于格式复杂的内容使用纯文本粘贴

## 找不到转换后的文件

**问题：** 转换完成但找不到 `.md` 文件。

**解决方案：**

* 检查与原始 `.docx` 文件 **相同的文件夹**
* 查找同名但扩展名为 `.md` 的文件
* 刷新文件管理器（重新加载图标）
* 在项目中搜索 `.md` 文件
* 尝试再次转换

## 转换后图片缺失

**问题：** Word 文档中的图片没有出现在 Markdown 中。

**解决方案：**

* 图片需要在 Markdown 中手动放置
* 从 Word 文档中单独提取图片
* 将图片放在 `images/` 文件夹中
* 在 Markdown 中手动添加图片引用：`![alt text](path)`

## 批量转换无法工作

**问题：** 无法一次转换多个文件。

**解决方案：**

* 确保 **Markdown Hub** 插件已安装
* 验证文件夹中的所有文件都是 `.docx` 格式
* 先尝试逐个转换文件
* 检查文件夹权限
* 重启 SoloEnt 并重试

## 特殊字符乱码

**问题：** 特殊字符或非英文文本显示不正确。

**解决方案：**

* 检查原始 Word 文档的编码
* 确保使用 UTF-8 编码
* 使用正确编码重新保存 Word 文档
* 在 Markdown 编辑器中手动修复字符

<Card title="返回文件转换指南" icon="file-import" href="../tips/file-format-conversion">
  返回主要转换指南
</Card>
