Germán Rodríguez
Stata Markdown Princeton University

A Research Article

The first published paper written completely using Stata and Markdown with the marksat command appeared in Demographic Research on March 22, 2017:

Germán Rodríguez and Trevor Croft (2017) "Extracting and reshaping World Fertility Survey data in Stata", Demographic Research, Volume 36, Article 31, Pages 893-904. http://www.demographic-research.org/volumes/vol36/31/36-31.pdf

I have to say writing in Markdown instead of LaTeX was a pleasure, and being able to incorporate Stata output without cutting and pasting was priceless.

The paper deals with a Stata command and a small challenge turned out to be the use of underlining to indicate minimal required abbreviations for options, as in directory(folder). The reason is that Markdown does not have a syntax for underlying! A related issue was using italics in a syntax diagram, because the backticks used to indicate code actually mean verbatim.

For HTML output I decided to use the tags <code> and </code> for code, <u> and </u> for underlining and <i> and </i> for italics (for use when * would be taken literally). For LaTeX output markstat 1.5.1 or later will translate these tags to the equivalent LaTeX command.

Returning to the paper, here are links to the input and output files:

Running markstat on the source file will reproduce the published paper except for minor differences in copy editing. Specifically, (1) we kept punctuation outside quoted variable and value labels, and (2) we did not edit Stata output, preserving the usual vertical rules.