慢慢写

用 Markdown 写报告,再转成 PDF

2026 年 10 月 22 日

课程报告我现在都用 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

几个参数的意思:

参考文献

正文里写 [@key],转换时加上 --citeproc --bibliography refs.bib,文末会自动生成文献列表。

踩过的坑

表格列太多会超出页面,这时把表格拆开,或者把那一页单独横过来。图片太大就在引用后面加宽度,比如 ![结果](img/result.png){width=70%}。