This is an example document to illustrate how it works.
Insert Stata code block wherever you want as following:
. ssc describe markstat ──────────────────────────────────────────────────────────────────────────────────────────────── package markstat from http://fmwww.bc.edu/repec/bocode/m ──────────────────────────────────────────────────────────────────────────────────────────────── TITLE 'MARKSTAT': module to support literate data analysis using Stata and Markdown DESCRIPTION/AUTHOR(S) The markstat command can be used to combine Stata code and results with comments and annotations written in Markdown, producing by default a web page. If a LaTeX installation is available, -markstat- can produce a PDF file from exactly the same input script. The command works by separating the code from the narrative, running the code through Stata, translating the narrative from Markdown to HTML or LaTeX using Pandoc, and then weaving the output files together. This avoids tedious cutting and pasting, and promotes reproducible research. The command puts a high premium on the simplicity of the input file, which emphasizes readability much in the spirit of Markdown itself. It supports Stata and Mata inline code, strict code blocks with an option to hide the commands, and mathematical equations. It can also handle citations, resolving them using a BiBTeX database and listing them at the end of the document. The command is described in a forthcoming Stata Journal article, and is supported by a website at http://data.princeton.edu/stata/markdown, which includes installation instructions, documentation, examples, and a comparison with the new tools in Stata 15. KW: markdown KW: data analysis Requires: Stata version 14, whereis from SSC, pandoc Distribution-Date: 20191213 Author: German Rodriguez, Princeton University Support: email grodri@princeton.edu INSTALLATION FILES (type net install markstat) markstat.ado markstat.css markstat.sthlp markstat.docx markstats5.zip ──────────────────────────────────────────────────────────────────────────────────────────────── (type ssc install markstat to install) . local 1 200 . if `1'==200 { . global mymacro "`1'" . di $mymacro 200 . } . sysuse auto // this is a comment (1978 Automobile Data) . gen price2=ln(price)
You can make a quote with >
as following:
this is a quote block,
which can be nested!
like this–note that you need a blank line.