Word to Markup

Standards to create a word file to use a markup file.

1. Use headers not bold.

Bolded text is not a header. The text below is bolded:

**Minutes of the Meeting**

**Date:** October 3, 2024

**Discussion Points:**

Modified for docusarus

---
last_update:
  date: 10/04/2024
  author: Melissa
tags: [GQC India, Meeting]
---
# Minutes of the Meeting 10/03/2024

**Discussion Points:**

1. Markdown there should be a single header at the top of the document. There can only be 1 Header level 1 in the document it should be treated as the title of the document.

2. If you use headers and subheader then that level of headers and sub-headers show up in the file.

   1. Remember the first level of headers will be the title so only use one of the top level header, the rest can be used as many times as you want.

   # Header Level 1 aka Tittle
   ## Header Level 2
   ### Header Level 3
   ### Header Level 4

3. Make your headers unique.

   1. If you do not make your headers unique in a document you will throw errors during compiling.

   Bad markdown using Description twice will cause errors.

   # Title of page
   
   ## Subheading 1
   
   ### Description
   
   ## Subheading 2
   
   ### Description
   

   The markdown below will not cause errors.

   # Title of page
   
   ## Subheading 1
   
   ### Subheader 1 Description
   
   ## Subheading 2
   
   ### Subheader 2 Description

Detailed instrutions for Word to Markdown.

1. Go to https://word2md.com/
2. There is a button Choose file. Click on it. It will open a dialogue box . Navigate to the word file you want to turn into a Markdown file.
3. If it doesn't automatically render, then click the submit button.
4. After that you will have a page with 2 primary sections, the Markdown, on the left and what it will look like Rendered on the right.
5. Above the Markdown and Rendered sections there is a button that says copy markdown to clipboard. Click on it.
6. Open Visual Studio Code.
7. Navigate to an appropriate folder.
8. Add a new file with the name of the Word file and the .md extension.
9. Paste the clipboard text into the Markdown file.
10. Word to markdown is not going to give you good pictures so you can just take them out.
    1. If you need the pictures then you need to click on the images and save them as .png files from the word document.
       1. Right click on the image you want to save.
       2. Pick Save as picture.
       3. Save the file as a .png with a meaningful name.
    2. Then you can add the pictures manually. Just put the pictures in a subfolder called images. Then add them to your read me in this format.

       ![alt text](images/image-1.png)
11. Remember to check your results as you go. And that this works best on simple documents that use Word style Headers.