Markdown Basics

Elvenware Logo



Markdown allows you to write a simple syntax defining a file. The markdown file can be read on its own, or converted to:

The point is to have one source file that can be used in multiple places. Perhaps more importantly, it ensures that we don't get locked into any one technology.

We use a slightly expanded syntax for markdown that can be compiled with Pandoc. You can install it from here:

The drawback is that it has only a limited number of things it can handle:

Read the documentation here:

You will also want to read this, of which the above is subset:


If Pandoc is hard for you to install, instead use Dillinger:

Use this with NPPExec in NotePad++. it will convert the markdown file currently in the editor to standalone HTML file with the same root name. For instance, it will convert tofoo.html.

"C:\Program Files (x86)\Pandoc\bin\pandoc.exe" -s -t html5 -o $(CURRENT_DIRECTORY)\$(NAME_PART).html "$(FULL_CURRENT_PATH)"

It means: