Academic Pandoc template

Logo

Write beautiful academic texts with the distraction-free Pandoc Markdown and typademic.

View the Project on GitHub maehr/academic-pandoc-template

Academic Pandoc template

Pandoc markdown templates for academic articles, presentations and theses to write distraction-free while maintaining beautiful typesetting.

GitHub issues GitHub forks GitHub stars GitHub license DOI

| from md | article | presentation | thesis | | :— | :—–: | :—–: | :—–: | | | | | | | to html | | | | | to docx | | | | | to epub | | | | | to pdf | | | | | to pptx | | | | | to tex | | | |

Getting Started

Follow the The Markdown Guide and make sure you have a Markdown editor like Zettlr and a Bibtex editor like JabRef installed.

Use it online

  1. Use this template or fork this repository.
  2. Edit article/article.md, presentation/presentation.md or thesis/ according to the The Markdown Guide online, with Zettlr or another Markdown editor
  3. Edit article/references.bib, presentation/references.bib or thesis/references.bib online, with JabRef or with your favorite Bibtex editor
  4. Commit your changes
  5. Manually run the Pandoc GitHub actions to build your document. They will be commited to main branch as well. a. Click on Actions in the top menu b. Click on Pandoc in the left menu c. Click on Run workflow in the top right corner

Use it locally

Install all prerequisites

Open your command line and execute on of the following commands.

Linting and formatting

Install the latest version of Node and all dependencies.

npm install

To use linting and formatting, use the following commands.

npm run check
npm run format

Configuration

Change the variables in the frontmatter in article/article.md, presentation/presentation.md or thesis/00.md to configure your document.

author:
  - '[Eleanor Roosevelt](eleanor.eoosevelt@domain.com)'
  - '[John Peters Humphrey](jph@domain.com)'
bibliography: references.bib # bibliography to use for resolving references
csl: https://www.zotero.org/styles/chicago-note-bibliography
date: 1 January 2023
keywords: # list of keywords to be included in HTML, PDF, ODT, pptx, docx and AsciiDoc metadata; repeat as for author, above
lang: en-US

Change the default files to your needs:

Conventional Commits

Use Conventional Commits for adding human and machine readable meaning to commit messages. To use commitizen, use the following commands.

npm run commit

Support

This project is maintained by @maehr. Please understand that we won’t be able to provide individual support via email. We also believe that help is much more valuable if it’s shared publicly, so that more people can benefit from it.

Type Platforms
🚨 Bug Reports GitHub Issue Tracker
🎁 Feature Requests GitHub Issue Tracker
🛡 Report a security vulnerability GitHub Issue Tracker

Built With

Roadmap

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments