Conversion fails
Problem: Word document won’t convert or shows error. Solutions:- Ensure file is valid
.docxformat (not.docor other formats) - Check file isn’t corrupted or password-protected
- Try opening and resaving in Microsoft Word
- Remove password protection before conversion
- Convert to
.txtfirst 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
.docxfile - Look for file with same name but
.mdextension - Refresh the file manager (reload icon)
- Search for
.mdfiles 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:
Batch conversion not working
Problem: Cannot convert multiple files at once. Solutions:- Ensure Markdown Hub plugin is installed
- Verify all files in folder are
.docxformat - 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
Back to File Conversion Guide
Return to the main conversion guide