用 Markdown 写报告,再转成 PDF
课程报告我现在都用 Markdown 写。好处是写的时候不用管字号和缩进,文件是纯文本,放进 Git 也能看出每次改了哪里。交的时候用 pandoc 转成 PDF。
目录怎么放
report/
report.md
img/ 图片放这里,正文里用相对路径引用
refs.bib 参考文献
转换命令
pandoc report.md -o report.pdf \
--pdf-engine=xelatex \
-V CJKmainfont="Noto Serif CJK SC" \
-V geometry:margin=2.5cm \
--number-sections --toc
几个参数的意思:
--pdf-engine=xelatex:中文要用 xelatex,默认的引擎排不了中文。CJKmainfont:指定中文字体,写系统里已经装了的字体名。geometry:margin:页边距。--number-sections --toc:给标题编号,并生成目录。
参考文献
正文里写 [@key],转换时加上 --citeproc --bibliography refs.bib,文末会自动生成文献列表。
踩过的坑
表格列太多会超出页面,这时把表格拆开,或者把那一页单独横过来。图片太大就在引用后面加宽度,比如 {width=70%}。