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 foo.md tofoo.html.
"C:\Program Files (x86)\Pandoc\bin\pandoc.exe" -s -t html5 -o $(CURRENT_DIRECTORY)\$(NAME_PART).html "$(FULL_CURRENT_PATH)"
Run Pandoc: "C:Files (x86).exe"
Create an standalone HTML5 file: -s -t html5
Put the output here: $(CURRENT_DIRECTORY)$(NAME_PART).html
Convert contents of file in the NPP editor: "$(FULL_CURRENT_PATH)"