Markdown syntax
There are some complication, like hyperlinks that I don't want to mention here, in order not to obscure the absolute simplicity of Markdown. This is what you'll use:
# Heading 1Nothing more.
## Heading 2
### Heading 3 (you get the point)
*bold*
**italic**

Markdown on OS X
One address: MacDown. It is a beautiful program that has a split screen set-up: left you have a WYSIWYM interface, right there is a live preview. Did I say it is beautiful? It's free.
Markdown on Windows
I have tried a few, but on Windows with no luck. There is always some premium function for sale and I don't like that. WriteMonkey is a good idea, but the pdf support is ... not included. There are also a bunch of web apps, most notably Dillinger and StackEdit. They look good, but I like to open a file from windows explorer and then that's just a pain.
In fact, gVim will do all you want, but there's a learning curve as it doesn't behave like normal textpads (I like notepad++ for instance as an in-between solution).
Two programs however will do the job, and they are software packages! Obviously, R is free, and Stata is not. You will know that I love Stata - I think it's the best, albeit expensive, textbook in statistics and it also has free software with it.
Markdown in R and Rstudio
Rstudio is brilliant software. Use the -knitr- package to enjoy writing markdown files and exporting to pdf. It's made for that and it's used by millions.
- About: http://yihui.name/knitr/
- How to install -knitr-: https://github.com/yihui/knitr#readme3
- Options: http://rmarkdown.rstudio.com/pdf_document_format.html
Markdown in Stata
Stata is a different beast. In a way it is less flexible and the markdown integration doesn't feel as native as in R. However, it is also easier.
You output an smlc log file, then you parse the file with the user command -markdoc- (Converting SMCL to Markdown and other formats using Pandoc). That's all there is to it. Remember to put your markdown code between command /* beginnings and endings */ which you put on separate lines. Also use - quietly - to reduce output.
There are a couple of other Stata programs doing a similar job:
- Weaver: HTML and PDF dynamic report producer
- Ketchup: HTML and PDF dynamic report producer
- Synlight: SMCL to HTML convertor and syntax highlighter
Just -ssc install- those and discover their help files.
For the Markdoc command, see:
For the Markdoc command, see: