Literate Data Analysis with Stata and Markdown

Literate Data Analysis with Stata and Markdown

In this article, I introduce markstat, 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 co...

Full description

Saved in:
Bibliographic Details
Published in:The Stata journal Vol. 17; no. 3; pp. 600 - 618
Main Author: Rodríguez, Germán
Format: Journal Article
Language:English
Published: Los Angeles, CA SAGE Publications 01-09-2017
Subjects:
Pandoc
dynamic documents
pr0067
LATEX literate programming
Markdown
markstat
reproducible research
Online Access:Get full text
Tags: Add Tag
No Tags, Be the first to tag this record!
Description
Summary:In this article, I introduce markstat, 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 LATEX and a style file from Stata but works with the same input file.
ISSN:1536-867X
1536-8734
DOI:10.1177/1536867X1701700304