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

# File Conversion Issues

> Troubleshoot document format conversion problems

Fix common issues when converting Word documents to Markdown.

## Conversion fails

**Problem:** Word document won't convert or shows error.

**Solutions:**

* Ensure file is valid `.docx` format (not `.doc` or other formats)
* Check file isn't corrupted or password-protected
* Try opening and resaving in Microsoft Word
* Remove password protection before conversion
* Convert to `.txt` first as a workaround
* Check file size (very large files may fail)

## Formatting looks wrong

**Problem:** Converted Markdown has formatting issues.

**Solutions:**

* This is normal for complex Word documents with advanced formatting
* Manually adjust Markdown formatting using the editor
* Simplify original Word document (remove complex styles, tables, etc.)
* Reconvert after simplification
* Use plain text paste for heavily formatted content

## Can't find converted file

**Problem:** Conversion completes but can't locate the `.md` file.

**Solutions:**

* Check the **same folder** as the original `.docx` file
* Look for file with same name but `.md` extension
* Refresh the file manager (reload icon)
* Search for `.md` files in project
* Try converting again

## Images missing after conversion

**Problem:** Images from Word document don't appear in Markdown.

**Solutions:**

* Images need manual placement in Markdown
* Extract images from Word document separately
* Place images in `images/` folder
* Add image references manually in Markdown: `![alt text](path)`

## Batch conversion not working

**Problem:** Cannot convert multiple files at once.

**Solutions:**

* Ensure **Markdown Hub** plugin is installed
* Verify all files in folder are `.docx` format
* Try converting files individually first
* Check folder permissions
* Restart SoloEnt and try again

## Special characters garbled

**Problem:** Special characters or non-English text appears incorrect.

**Solutions:**

* Check original Word document encoding
* Ensure UTF-8 encoding is used
* Resave Word document with correct encoding
* Manually fix characters in Markdown editor

<Card title="Back to File Conversion Guide" icon="file-import" href="../tips/file-format-conversion">
  Return to the main conversion guide
</Card>