Converting the .md File Into a Single Document

convertmdfile.md

🧩 Converting the .md File Into a Single Document

The Pandoc software tool can be used to create a new document that combines all the images, videos, and other content within an .md file into a single unified document. In this way, Pandoc can find images in directories such as <img src="mats/imgs/welder.gif" align="right" height="400"> or ![image](mats/imgs/welder.gif), which are relative paths within the .md file, embed them into the document, and create a new document within a single document.

Warning

For example, in order for Pandoc to embed images or other components into the newly created document, the directory location, name, and organization must be the same as specified in the relative paths in the README.md file.

Example

1. Install Pandoc into your Linux system

sudo apt install pandoc

2. Install your Github repo and go to in it
3. Ensure your README.md file here with its materials (images, gifs, videos etc.) in the directory
4. Use pandoc command like that;

pandoc README.md -o output.html \
                    --from gfm \
                    --self-contained \
                    --standalone \
                    --metadata title="My New Document"

5. Like this, you convert your README.md file to output.html

Note

The --from gfm parameter indicates that the file to be converted is in GitHub Markdown format.