An academic CV in Markdown, typeset by LaTeX

A CV changes every few months and should look the same for years. Keep the words in a Markdown file you can edit anywhere, and let a LaTeX template do the typesetting. This template is free. It works with Pandoc, and with Grasmere on a Mac.

Download the template Free to use and change · .zip, 29 KB

The first page of the example CV: the name in small capitals, then Research interests, Education, Appointments and Publications, each under a ruled heading

What’s in the download

Write the CV in Markdown

The CV is an ordinary Markdown document. Your name goes at the top, as the author. Each ## heading is a section, and a list holds the things you’d expect to list.

---
author: Rosa Field
---

# Curriculum Vitae

Department of History, University of Kelder, Fold End, Cumbria

[email protected] · [rosafield.example](https://rosafield.example)

## Education

**PhD in History**, University of Kelder, 2023. Thesis: *Winter Crossings
on Kelder Water, 1890–1940*. Supervisor: Professor Margaret Abbott.

## Publications

### Books

- *The Living Loaf: Bread and the Household in Northern England*.
  2nd ed. London: Riverbank Press, 2019.

### Articles and chapters

- “The Boy Who Walked the Shore: Parish Relief and the Frozen Ferry.”
  *Journal of Lakeland History* 41, no. 2 (2024): 112–138.

There’s nothing to learn beyond Markdown, and nothing in the file that only one app understands. When you publish something new, you add a line.

What the template does with it

In your MarkdownOn the page
The authorYour name, large, in small capitals, and at the foot of each page.
The # titleA line in italics beneath your name.
A ## headingA section, in small capitals over a rule.
A ### headingA bold heading inside a section, such as Books.
A listEntries with a hanging indent and no bullets, as a list of publications is usually set.
A list inside a listBullets.
Bold, italics and linksThe same. Links can be clicked in the PDF.

The type is Palatino, on A4 with one-inch margins, and the pages are numbered.

Make the PDF with Pandoc

If you have Pandoc and a LaTeX engine, one command makes the PDF.

pandoc cv.md --shift-heading-level-by=-1 --template academic-cv.tex -o cv.pdf

The --shift-heading-level-by=-1 part makes the # heading the title and each ## a section. Add --pdf-engine=tectonic or --pdf-engine=xelatex to choose the engine.

With no LaTeX on your computer, ask Pandoc for the .tex and compile it in Overleaf, which is free and runs in the browser.

pandoc cv.md --shift-heading-level-by=-1 --template academic-cv.tex -o cv.tex

Make it with Grasmere

New in 1.6. Grasmere is a Mac app for long writing in Markdown, and its Publish stage writes LaTeX in a template of your choosing.

  1. Put academic-cv.tex anywhere in your project. A .tex file with a place marked for the text is a template.
  2. Open your CV and press ⌃T to put it in hand, then go to the Publish stage.
  3. Type “Curriculum Vitae” as the Title and your name as the Author.
  4. Click LaTeX, choose a folder, and choose academic-cv as the template.

Grasmere writes the .tex into the folder. Open it in TeXShop or upload it to Overleaf to make the PDF. Grasmere takes your name from the Author box, so the author: line in the file is only for Pandoc.

Change how it looks

The template is one short file with a comment over each part, and it’s yours to edit.

  • Paper. Change a4paper to letterpaper for US Letter, and margin=1in for the margins.
  • Type. Swap the Palatino lines for another font package.
  • Bullets. Remove the line that begins \setlist[itemize,1] to have ordinary bulleted lists.
  • The date. The foot of each page shows the date when one is given. Grasmere gives today’s. With Pandoc, add date: beside author:.

Questions

Do I need Grasmere to use it?

No. It’s a Pandoc template, and it works anywhere Pandoc does.

Which LaTeX engine does it need?

It’s written for pdfLaTeX, XeLaTeX and LuaLaTeX, and uses only packages that come with TeX Live.

Can I use it for a résumé?

Yes. Leave out the sections you don’t need and keep it to a page or two. It’s plain enough for either.

May I change it and share it?

Yes, for any purpose.

The rest of your writing, in Markdown too.

Grasmere takes a thesis, a paper or a book from sources to submission in plain Markdown files. The trial is free for 14 days.

Download for macOS Free for 14 days, then $14.99 once · macOS 26+

Last updated .