👇 连享会 · 推文导航 | www.lianxh.cn
🍎 Stata：Stata基础 | Stata绘图 | Stata程序 | Stata新命令 📘 论文：数据处理 | 结果输出 | 论文写作 | 数据分享 💹 计量：回归分析 | 交乘项-调节 | IV-GMM | 时间序列 | 面板数据 | 空间计量 | Probit-Logit | 分位数回归 ⛳ 专题：SFA-DEA | 生存分析 | 爬虫 | 机器学习 | 文本分析 🔃 因果：DID | RDD | 因果推断 | 合成控制法 | PSM-Matching 🔨 工具：工具软件 | Markdown | Python-R-Stata 🎧 课程：最新专题 | 计量专题 | 关于连享会
🍓 课程推荐：2024 机器学习与因果推断专题
主讲老师：司继春 (上海对外经贸大学) ；张宏亮（浙江大学）
课程时间：2024 年 11 月 9-10 日 ；16-17日
课程咨询：王老师 18903405450（微信）
课程特色 · 2024机器学习与因果推断：
懂原理、会应用。本次课程邀请了两位老师合作讲授，目的在于最大限度地实现理论与应用的有机结合。为期四天的课程，分成两个部分：第一部分讲解常用的机器学习算法和适用条件，以及文本分析和大语言模型；第二部分通过精讲 4-6 篇发表于 Top 期刊的论文，帮助大家理解各类机器学习算法的应用场景，以及它们与传统因果推断方法的巧妙结合。 以 Top 期刊论文为范例。目前多数人的困惑是不清楚如何将传统因果推断方法与机器学习结合起来。事实上，即便是 MIT 和 Harvard 的大牛们也都在「摸着石头过河」。为此，通过论文精讲和复现来学习这部分内容或许是目前最有效的方式了。张宏亮老师此前在浙江大学按照这一模式教授了「因果推断和机器学习」课程，效果甚佳：学生们能够逐渐建立起研究设计的理念，并在构造识别策略时适当地嵌入机器学习方法。
作者：陈楚 (中山大学岭南学院)
邮箱：chench528@mail2.sysu.edu.cn
温馨提示： 文中链接在微信中无法生效。请点击底部「阅读原文」。或直接长按/扫描如下二维码，直达原文：
目录
1. 引言
2. 命令与程序
3. markstat 文件
3.1 新建 Do-file 并编写动态文档
3.2 动态文档的编写方式及技巧
3.3 markstat 文件 (.stmd) 的保存
4. markstat 命令使用
5. 实例演示
6. 参考资料
7. 相关推文
1. 引言
markstat 是一个将 Stata 的代码、输出结果与用 Markdown 编写的注释完美结合成一个动态文档命令。该命令还可以将文档输出成幻灯片、 PDF 或者 Word 的格式，为我们写 Stata 讲义、Stata 作业以及制作包含 Stata 代码的幻灯片提供了极大的便利。
在数据分析领域，仔细记录所有步骤，包括数据处理、数据分析以及表格和图表的生成，对于结果的可重复性是至关重要的。实现这一目标最有效的方法是将数据分析代码、各步骤详细注释和结果集成在一个单一的文档中，markstat 命令可以帮助我们仅用 Stata 就实现这一目标。
总的来看，利用 markstat 命令生成一份幻灯片、PDF 或 Word 文档需要以下几个步骤：
下载安装好 Stata 两命令，外部两程序：两命令 markstat和whereis，两程序 Pandoc 和 LaTeX；编写和生成 markstat 文件(.stmd)：以 Do-file 为载体，按照既定的编写规则来编写想要生成的动态文档内容，并保存为 .stmd 文件； 借助 markstat语法完成目标格式的输出：markstat using filename [, options ]是markstat命令的语法，选择合适的option即可完成格式输出，详见下文。
2. 命令与程序
在借助 markstat 命令完成动态文档的编写目标之前，我们需要先安装一些命令和程序，具体如下：
markstat：用于将动态文档中 Markdown 和 Stata 代码分别提取到单独的 .md 和 .do 文件中，并将各自的运行结果集成至单一文档中；whereis：用于指定外部程序和辅助文件的路径目录；Pandoc：用于运行 Markdown 代码将其转换成 HTML，PDF 或 DOCX 的程序； LaTeX：只有需要通过 LaTeX 生成 PDF 文档时，才需要下载该程序。更简单的替代方法是先生成 HTML，然后用 Chrome 等浏览器将其另存为 PDF，或将文件读取到 Word 中，然后将其另存为 PDF。
markstat 和 whereis 是 Stata 中的两个外部命令，需要用如下命令安装：
ssc install markstat, replace
ssc install whereis, replace
Pandoc 和 LaTeX 是两个外部程序，可以分别点击 Pandoc 和 LaTeX 跳转到其对应官网进行下载。下载安装好后，在 Stata 中借助 whereis 命令指定对应程序的位置。
. * 借助 whereis 命令指定 Pandoc 程序的位置 (引号内为你电脑里程序的位置路径)
. whereis pandoc "c:\program files (x86)\pandoc\pandoc.exe"
. * 借助 whereis 命令指定 pdflatex 程序的位置 (引号内为你电脑里程序的位置路径)
. whereis pdflatex "c:\program files (x86)\pandoc\pdflatex.exe"
. * Note: pdflatex 是 LaTeX 的 PDF 转换器，下载安装好 LaTeX 后找到其中的 pdflatex 程序路径即可
3. markstat 文件
在 Stata 中，markstat 命令仅适用于 markstat 文件 (.stmd)，因此我们需要先将包含 Stata 代码和 Markdown 注释的动态文档转成 .stmd 格式，再借助 markatat 命令将该文档输出成我们想要的形式。通常的做法是我们现在 Do-file 中编写动态文档，然后将其另存为 markstat 文件(.stmd)。另存时有两个注意事项，详见下图：
3.1 新建 Do-file 并编写动态文档
在 Stata 中新建 Do-file 后即可编写文档，其中 Stata 代码需要缩进 1 个 Tab 或 4 个空格以作区分。如下例所示，正常编写的是 Markdown 代码，缩进的是 Stata 代码。
Let us read the fuel efficiency data that ships with Stata
sysuse auto, clear
To study how fuel efficiency depends on weight it is useful to
transform the dependent variable from "miles per gallon" to
"gallons per 100 miles"
gen gphm = 100/mpg
We then obtain a fairly linear relationship
twoway scatter gphm weight || lfit gphm weight, ///
ytitle(Gallons per 100 Miles) legend(off)
graph export auto.png, width(500) replace
The regression equation estimated by OLS is
regress gphm weight
Thus, a car that weighs 1,000 pounds more than another requires
on average an extra 1.4 gallons to travel 100 miles.
That's all for now!
3.2 动态文档的编写方式及技巧
3.2.1 Markdown 注释
markstat 文件支持绝大多数 Markdown 语法，我们可以直接在用 Do-file 编写动态文档时使用 Markdown 语法以实现想要的注释效果。具体来看，
标题
# 一级标题
## 二级标题
### 三级标题
文字效果和分隔线
*斜体*
**粗体**
~~删除线~~
**** (分隔线 1)
---- (分隔线 2)
列表
无序列表
* 红色
+ 绿色
- 蓝色
有序列表
1. 打开冰箱
2. 塞入大象
3. 关上冰箱
文本链接
学习 [<font color=darkgreen>Stata</font>](http:\\http://www.stata.com) 过程中遇到问题，
可以查看 [<font color=darkgreen>老连</font>](http://www.lingnan.sysu.edu.cn/lnshizi/faculty_vch.asp?name=lianyj "连玉君主页")
的 [<font color=darkgreen>知乎专栏</font>](https://zhuanlan.zhihu.com/arlion "连玉君 Stata 知乎专栏")。
图片链接
表格
----: 为右对齐
:---- 为左对齐
:---: 为居中对齐
----- 为使用默认居中对齐
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
3.2.2 Markdown 公式
正如 Markdown 语言一样，markstat 文件可以借助 Pandoc 程序将美元符号 $ 之间的任何文本解释为 LaTeX 公式，借助这种方式我们在 Do-file 中也可以轻易写出复杂的数学方程。
行内公式： $行内公式$行间公式： $$行间公式$$，公式后加\quad(#)可以手动添加编号，其中#为公式编号
$$
y_i = \beta_0 + x_i\beta_1 + \epsilon_i \quad(1)
$$
其中，$\epsilon_i$ 表示干扰项，$i=1, 2, \cdots, N$。
3.2.3 Metadata 元数据
Pandoc 允许将文档的标题、作者和日期作为元数据，只需在文档的前三行写明对应的信息并以 % 开头。
% Dynamic Documents with Stata and Markdown
% Germán Rodríguez, Princeton University
% 4 November 2017
我们也可以使用 YAML 格式，以三个短划线 - 来开始和结束整个区块，可以达到同样的效果。
---
title: Dynamic Documents with Stata and Markdown
author: Germán Rodríguez, Princeton University
date: 4 November 2017
---
Note：如果想使用文档运行时的日期，可以键入 `s c(current_date)` 而不是确切的日期。
3.2.4 Fenced Code Blocks 代码块
通过“一个制表符或四个空格”的简单规则来区分 Stata 和 Markdown 代码非常便捷且效果不错，但这使得一些高级的 Markdown 用法无法正常使用，如嵌套列表。因此，markstat 的 strict 选项使用代码块来区分 Stata 代码。
以 ```s 开头，``` 结尾，在这中间编写 Stata 代码； 以 ```{s} 开头，``` 结尾，与上一种方式等价。
```s
sysuse auto, clear
reg price weight length
```
以 ```s/ 开头，``` 结尾，只显示输出结果，不显示 Stata 的代码命令
```s/
sysuse auto, clear
reg price weight length
```
3.2.5 Inline Code 内联代码
我们可以通过使用内联代码作为叙述的一部分来引用结果，markstat 命令将借助 Stata 的 display 命令将内联代码显示化，并将输出与文本内联拼接。内联代码语法：`s [fmt] expression`，其中 [fmt] 是一个可选格式，后面跟着一个表达式。
qui sysuse auto, clear
qui reg price weight length
回归得到的R方 `s %5.2f e(r2)` 是模型的可决系数
3.2.6 Figures 图像
默认情况下，图像在 HTML 中使用其实际大小呈现，在 PDF 中使用行宽的 75% 呈现，但我们可以为其添加宽度属性以改变其大小。
使用 in 设定英寸宽度 使用 cm 设定厘米宽度 使用 % 设定相对尺寸
*- 语法格式
{width=100%}
3.2.7 Citations 引用
markstat 命令还可以帮助我们处理参考书目的引用问题，我们首先要为引用的文献创建一个 BibTeX 数据库，并在文档 YAML 元数据中包含对该文件的引用。
Step 1：创建 BibTeX 数据库。找到引文的 BibTeX 引用格式，将其复制到一个空白的文本文档中，而后将文档的 .txt 扩展名更改为 .bib，使其变成 BibTeX 源文件。
Note：Google 学术中的文献直接可以选择 BibTeX 的引用格式，而知网等网站里的中文文献没有该引用格式。中文文献的 BibTeX 引用可以参考 知网 BibTeX 自动生成 来完成。
Step 2：在 YAML 的 metadata 中包含引用的文献信息。在讲 Metadata 元数据的时候我们提到了 YAML 格式，此时只需要在之前设置的基础上加上 bibliography 的源文件名称即可，本文中 BibTeX 源文件名称为 citation.bib。
---
title: Dynamic Documents with Stata and Markdown
author: Germán Rodríguez, Princeton University
date: 4 November 2017
bibliography: citation.bib
---
在后文的写作中我们可以用 @符号 + 引文的键名进行引用。
Germán Rodríguez [-@rodriguez2017literate] 发表在 Stata Journal 上的文章详细介绍了这一命令。
## References // 在文末给引用部分加上标题
Note：不同的引用方式可以参考 Bibliographic Citations。
Step 3：在后面执行 markstat 命令时加上 bibliography 选项。
3.2.8 幻灯片编写方式
markstat 命令可以借助 S5 引擎将幻灯片输出成 HTML 文件，也可以借助 Beamer 将幻灯片输出成 PDF 格式。
幻灯片分页：通常，我们借助 --- 来手动分割幻灯片页面，并将一级标题默认为幻灯片标题。而在结构简单的幻灯片中，markstat 可以自动识别各一级标题来分割幻灯片。如果使用 Beamer，要在包含 Stata 命令和输出的幻灯片页的标题中添加 {.fragile}。
* 借助 --- 进行页面分割
# 1st page // 这是第1页
The content of 1st page
---
## 2nd page### The content of 2nd page // 这是第2页
Hello, world!
---
# 3rd page // 这是第3页
Thanks
* 根据幻灯片一级标题进行页面分割
# 1st page // 这是第1页
The content of 1st page
## lst page### The content of 2nd page
Hello, world!
# 2rd page // 这是第2页
Thanks
分列式幻灯片：为了使幻灯片页面结构更加清晰，我们可以采用分列布局，例如简洁明了的左右结构，左边展示 Stata 代码，右边展示 Stata 代码的输出结果。
以 :::::: {.columns}表明分列的开始；以 ::: {.column}开始，:::结束，中间为各列想要展示的内容；以 ::::::为结尾表明分列结束。
% Two-Column Slides
% Germán Rodríguez
% November 10, 2017
# A side-by-side structure {.fragile}
Here's the code and graph side-by-side:
:::::: {.columns}
::: {.column} // 第一次分列内容开始
```s
sysuse auto, clear
gen gphm = 100/mpg
qui twoway scatter gphm weight ///
|| lfit gphm weight, ///
ytitle(Gallons per 100 Miles) ///
legend(off)
graph export A.png,replace
```
::: // 第一次分列内容结束
::: {.column} // 第二次分列内容开始
{width="80%"}
::: // 第二次分列内容开始
::::::
Above is a clear example. This is a slide structure worth learning.
3.3 markstat 文件 (.stmd) 的保存
我们将写好的 Do-file 保存为 auto.do 文件，其中 auto 是自定义的文件名称，.do 是 Do-file 文件的扩展名。然后通过重命名文件来更改文件扩展名为 .stmd，使得最终文件名变为 auto.stmd 即可，此时该文件成功变成 markstat 文件。
Note：有些电脑为文件隐藏了扩展名，在这种情况下即使将文件重命名为 auto.stmd ，在后续运行 markstat 命令时 Stata 仍会报错。解决这个问题的方法是在电脑中打开 文件资源管理器选项，点击 查看 窗口，取消勾选 隐藏已知文件类型的扩展名。此时我们会发现原本命名为 auto.stmd 的文件的完整名称为 auto.stmd.do，我们通过重命名删掉 .do 后缀即可。
4. markstat 命令使用
markstat 命令唯一需要的参数是 markstat 文件 (.stmd) 的文件名，前面我们已经完成了 markstat 文件的编写，接下来我们将详细介绍 markstat 命令的使用方法。
markstat 命令语法：
markstat using filename [, pdf docx slides beamer mathjax bundle bibliography strict nodo nor keep ]
markstat 命令选项：
pdf：用于生成 PDF 文件，使用该选项需要下载 pdflatex 程序，并用whereis命令指定程序位置，然后需要输入命令copy http://www.stata-journal.com/production/sjlatex/stata.sty stata.sty命令来下载 stata.sty。替代方法是先将文档输出为 HTML 文件，然后用 Chrome 等浏览器将其另存为 PDF 文件，或先输出为 Word 文档，然后将其另存为 PDF 文件。docx：用于生成 Word 文档。slides：用于利用 S5 生成 HTML 形式的幻灯片，可以在括号中添加幻灯片主题，例如slides(santiago)使用 santiago 主题。beamer：通过 LaTeX 使用 Beamer 生成 PDF 形式的幻灯片，可以选择任意 Beamer 主题，例如beamer(marid)。可以点击 Beamer theme gallery (uab.es) 查看不同的主题样式。mathjax：用于激活 MathJax JavaScript 库，它能很好地在网页上呈现数学方程式。bundle：使用 base64 对所有图像和辅助文件进行编码，来生成含带的 HTML 文档。bibliography：用于使用 BibTeX 数据库解析引文，并在文档末尾生成参考文献列表。strict：决定如何分离文档中的 Markdown 和 Stata 代码。“一个 Tab 或四个空格”的区分规则很简单，但它限制了一些 Markdown 的高级用法。strict使得文档严格根据代码块来区分 Markdown 和 Stata 代码。nodo：用于在调整文档时跳过运行 Stata 代码。可以使我们将输出的幻灯片从 S5 更改为 Beamer，或尝试不同的主题时，无需重新运行 Stata 代码，而是直接输出最近的 Stata 运行结果。nor：对于与nodo命令类似，将使文档在输出时跳过 R 代码，而直接使用最新的输出结果。keep：将保存默认情况下删除的中间文件。默认情况下，只保留 smcl 和 rout 文件以确保nodo和nor命令的正常运行，当然还有输出文件。使用keep命令则保留所有内容，使用keep(list)可保留选定的文件。例如keep(do md)保留生成的 Stata do 文件和 Markdown 文件。
Note：在使用 markstat 命令前需要确保 Stata 找得到 markstat 文件，可以借助 cd 命令调整 Stata 的当前路径与文件路径一致，也可以用包含文件路径的形式来输入文件名。
5. 实例演示
将本文 3.1 小节中的 Stata 代码另存为 example.stmd 文件，然后借助 markstat 命令的简单语法即可完成输出。
whereis pandoc "c:\program files (x86)\pandoc\pandoc.exe" // 指定 Pandoc 程序的位置
whereis pdflatex "c:\program files (x86)\pandoc\pdflatex.exe" // 指定 pdflatex 程序的位置
cd "D:\study\sysu\EF\markstat" // 调整 Stata 的当前路径与 .stmd 文件路径一致
markstat using example // 生成HTML
markstat using example, docx // 生成Word
markstat using example, pdf // 生成PDF
markstat using example, beamer // 生成PDF形式的幻灯片 (记得加上“---”来分割页面)
6. 参考资料
命令主页：markstat Germán Rodríguez. Literate Data Analysis with Stata and Markdown[J]. The Stata Journal,2017,17(3). -PDF-
7. 相关推文
Note：产生如下推文列表的 Stata 命令为：
lianxh markdown, m
安装最新版lianxh命令：
ssc install lianxh, replace
专题：Markdown-LaTeX 连玉君-Marp：用Markdown快速写幻灯片 Markdown笔记利器：Typora主题-最美的模板 Markdown写作神器：五分钟Typora教程 Markdown-LaTeX：经管人的VSCode配置大全 用VScode正则表达式转换Markdown和LaTeX链接 学术范儿的幻灯片制作：Beamer in Rmarkdown 用Markdown制作幻灯片-五分钟学会Marp（上篇）-M110a 用Markdown制作幻灯片-五分钟学会Marp（下篇）-M110b 学术论文写作新武器：Markdown-上篇 学术论文写作新武器：Markdown-中篇 学术论文写作新武器：Markdown-下篇 Markdown：五分钟Markdown教程 Markdown教程之LaTeX数学公式简介 Markdown：一键将-Word-转换为-Markdown Markdown-图床 Markdown常用LaTex数学公式 连玉君Markdown笔记 Markdown中书写LaTeX数学公式简介 在 Markdown 中使用表情符号 在 Markdown 中使用表情符号 mdnice.cn——Markdown、知乎、公众号排版神器 两种网页转Markdown的简便方法 专题：工具软件 Markdown图片神器：PicGo-让你爱上笔记与分享 毕业季10分钟Markdown简历——风格瞬间变
🍓 课程推荐：2024 机器学习与因果推断专题
主讲老师：司继春 (上海对外经贸大学) ；张宏亮（浙江大学）
课程时间：2024 年 11 月 9-10 日 ；16-17日
课程咨询：王老师 18903405450（微信）
尊敬的老师 / 亲爱的同学们：
连享会致力于不断优化和丰富课程内容，以确保每位学员都能获得最有价值的学习体验。为了更精准地满足您的学习需求，我们诚挚地邀请您参与到我们的课程规划中来。请您在下面的问卷中，分享您 感兴趣的学习主题或您希望深入了解的知识领域 。您的每一条建议都是我们宝贵的资源，将直接影响到我们课程的改进和创新。我们期待您的反馈，因为您的参与和支持是我们不断前进的动力。感谢您抽出宝贵时间，与我们共同塑造更加精彩的学习旅程！https://www.wjx.cn/vm/YgPfdsJ.aspx# 再次感谢大家宝贵的意见！
New！ Stata 搜索神器：
lianxh和songblGIF 动图介绍
搜： 推文、数据分享、期刊论文、重现代码 ……
👉 安装：
. ssc install lianxh
. ssc install songbl
👉 使用：
. lianxh DID 倍分法
. songbl all
🍏 关于我们
连享会 ( www.lianxh.cn，推文列表) 由中山大学连玉君老师团队创办，定期分享实证分析经验。 直通车： 👉【百度一下： 连享会】即可直达连享会主页。亦可进一步添加 「知乎」,「b 站」,「面板数据」,「公开课」 等关键词细化搜索。
