> ## 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 Format Conversion

> Convert Word documents to Markdown format

Import your existing Word documents into SoloEnt by converting them to Markdown format.

## Single file conversion

Convert individual `.docx` files to Markdown:

<Steps>
  <Step title="Locate the file">
    Find your `.docx` file in the file manager.
  </Step>

  <Step title="Right-click">
    Right-click on the file to open the context menu.
  </Step>

  <Step title="Convert">
    Select **"Convert to Markdown"** from the menu.
  </Step>

  <Step title="Wait for completion">
    The file converts automatically. A new `.md` file appears in the same location.
  </Step>
</Steps>

<Info>
  The original `.docx` file remains unchanged. The converted Markdown file is created as a new file.
</Info>

## Batch conversion

Convert multiple Word documents at once using the “**Markdown Hub**” plugin:

<Steps>
  <Step title="Install Markdown Hub">
    1. Click the **Extensions** icon in the left sidebar (third icon)
    2. Search for **"Markdown Hub"**
    3. Click **Install** (it's free)
  </Step>

  <Step title="Organize files">
    Place all `.docx` files you want to convert in the same folder.
  </Step>

  <Step title="Right-click folder">
    Right-click on the folder containing your `.docx` files.
  </Step>

  <Step title="Convert all">
    Select **"Convert to Markdown"** to batch convert all documents in the folder.
  </Step>
</Steps>

<Tip>
  Use batch conversion to import your entire existing work library at once.
</Tip>

## Supported formats

| Format  | Import | Export | Notes          |
| ------- | ------ | ------ | -------------- |
| `.docx` | ✅      | ❌      | Word documents |
| `.md`   | ✅      | ✅      | Native format  |
| `.txt`  | ✅      | ✅      | Plain text     |
| `.pdf`  | ❌      | ✅      | Export only    |

<Note>
  Markdown (`.md`) is SoloEnt's native format. All editing features work best with Markdown files.
</Note>

## Conversion quality

### What converts well

* **Text content**: Paragraphs, headings, lists
* **Basic formatting**: Bold, italic, underline
* **Structure**: Chapters, sections, subsections

### What may need adjustment

* **Complex tables**: May require manual formatting
* **Images**: Need to be manually placed in the images folder
* **Custom styles**: Convert to standard Markdown formatting
* **Comments and tracked changes**: Not preserved

<Warning>
  Review converted files for formatting issues. Complex Word documents may need manual cleanup.
</Warning>

## After conversion

<Steps>
  <Step title="Review content">
    Open the converted Markdown file and check for formatting issues.
  </Step>

  <Step title="Fix formatting">
    Adjust any elements that didn't convert cleanly.
  </Step>

  <Step title="Organize files">
    Move files to appropriate folders (chapters, outline, etc.).
  </Step>

  <Step title="Start editing">
    Begin working with your imported content.
  </Step>
</Steps>

<Tip>
  **Let Agent do the work:** Ask Agent to handle these tasks automatically. For example: "Review the converted file and fix formatting issues" or "Organize imported files into chapters folder."
</Tip>

## Best practices

<AccordionGroup>
  <Accordion title="Prepare Word documents">
    * Use standard styles (Heading 1, 2, 3, etc.)
    * Avoid complex formatting
    * Remove unnecessary styling before conversion
  </Accordion>

  <Accordion title="Test with one file first">
    * Convert a single file to check quality
    * Adjust your Word document if needed
    * Then proceed with batch conversion
  </Accordion>

  <Accordion title="Backup originals">
    * Keep your original `.docx` files
    * Store backups before converting
    * You can always reconvert if needed
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Conversion fails">
    * Ensure file is a valid `.docx` format
    * Check file isn't corrupted or password-protected
    * Try opening and resaving in Word
    * Convert to `.txt` first as a workaround
  </Accordion>

  <Accordion title="Formatting looks wrong">
    * This is normal for complex documents
    * Manually adjust Markdown formatting
    * Simplify original Word document and reconvert
  </Accordion>

  <Accordion title="Can't find converted file">
    * Check the same folder as the original
    * Look for a file with the same name but `.md` extension
    * Refresh the file manager
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Editor features" icon="pen-to-square" href="./Editor">
    Learn Markdown editing
  </Card>

  <Card title="Organize project" icon="folder-tree" href="./create-project">
    Structure your imported files
  </Card>
</CardGroup>