Converting a Word Doc to Markdown

Conversion Process

To convert a .docx file from Microsoft Word to reStructuredText follow the below steps.

Note

The conversion process will place all of the course content into a single reStructedText file.

1. Download or git clone the f5-agility-lab-template

2. Copy your .docx file into the f5-agility-lab-template directory

3. Run the below command at the the command line.

   $: `./containthedocs-convert.sh <filename.docx>`

4. Your converted file will be named filename.rst

5. Images in your document will be extracted and placed in the media directory

Fixing the Converted Document

1. Create an additional reStructedText file for each major section in your document.

2. Copy and paste the converted text from the originally converted text file to the new reStructedText file.

Verify Content Accuracy

1. Check each reStructedText file to ensure that formatting is correct.

2. Ensure that the images were converted successfully and look correct.

Warning

Images may not have converted correctly and may need to be recaptured!