Literate Data Analysis with Stata and Markdown. (September 2017)

• Record Type: Journal Article
• Authors: Rodríguez, Germán
• Is Part Of: Stata journal. Volume 17:Number 3(2017)
• Page Start: 600
• Page End: 618
• Publication Date: 2017-09
• Subjects: pr0067 -- markstat -- Markdown -- Pandoc -- LATEX literate programming -- dynamic documents -- reproducible research; Statistics -- Periodicals; Statistics -- Computer programs -- Periodicals; 001.422
• DOI: 10.1177/1536867X1701700304
• Languages: English
• ISSNs: 1536-867X

Abstract

In this article, I introducemarkstat, a command for combining Stata code and output with comments and annotations written in Markdown into a beautiful webpage or PDF file, thus encouraging literate programming and reproducible research. The command tangles the input separating Stata and Markdown code, runs the Stata code, relies on Pandoc to process the Markdown code, and then weaves the outputs into a single file. HTML documents may include inline and display math using MathJax. Generating PDF output requires access to L A TE X and a style file from Stata but works with the same input file.