Sphinx+MacTex从markdown输出html, pdf和tex文档

pip3 install -U sphinx recommonmark sphinx-rtd-theme --user #sphinx支持markdown
brew cask install mactex
mkdir demo
cd demo
sphinx-quickstart

然后在demo目录下执行

make html #生成html文档(demo/build/html目录中),使用sphinx_rtd_theme模板
make latexpdf #直接生成pdf文档
make latex #生成tex文档, 此tex文档可以使用TexShop被再次修改

根据tex文档生成pdf文档

cd demo/build/latex
xelatex demo.tex #由tex文档生成pdf文档

在demo/source/conf.py文件中添加以下内容来支持markdown语法

extensions = ['recommonmark']

source_suffix = {
    '.rst': 'restructuredtext',
    '.md': 'markdown',
}

html_theme = 'sphinx_rtd_theme'