{"id":14173172,"url":"https://github.com/cagix/pandoc-thesis","last_synced_at":"2026-02-26T12:40:43.603Z","repository":{"id":44432285,"uuid":"198233774","full_name":"cagix/pandoc-thesis","owner":"cagix","description":"Pandoc Thesis Template: A Template for Thesis Documents written in Markdown","archived":false,"fork":false,"pushed_at":"2026-02-20T16:46:41.000Z","size":1778,"stargazers_count":98,"open_issues_count":23,"forks_count":27,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-02-20T20:59:48.208Z","etag":null,"topics":["docker","eisvogel","latex","markdown","oer","open-educational-resources","pandoc","pandoc-thesis","thesis"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cagix.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-07-22T13:56:31.000Z","updated_at":"2026-02-20T17:22:38.000Z","dependencies_parsed_at":"2023-11-27T14:41:48.448Z","dependency_job_id":"8563507b-f0c6-4d76-a1cf-688f9201c3c9","html_url":"https://github.com/cagix/pandoc-thesis","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cagix/pandoc-thesis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cagix%2Fpandoc-thesis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cagix%2Fpandoc-thesis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cagix%2Fpandoc-thesis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cagix%2Fpandoc-thesis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cagix","download_url":"https://codeload.github.com/cagix/pandoc-thesis/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cagix%2Fpandoc-thesis/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29859231,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-26T08:51:08.701Z","status":"ssl_error","status_checked_at":"2026-02-26T08:50:19.607Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","eisvogel","latex","markdown","oer","open-educational-resources","pandoc","pandoc-thesis","thesis"],"created_at":"2024-08-17T23:01:28.131Z","updated_at":"2026-02-26T12:40:43.569Z","avatar_url":"https://github.com/cagix.png","language":"TeX","funding_links":[],"categories":["Popular \u0026 New Non-LaTeX Templates"],"sub_categories":["Thesis/Dissertation"],"readme":"\u003c!--  pandoc -s -f markdown -t markdown+smart-grid_tables-multiline_tables-simple_tables --columns=94 --reference-links=true  README.md  -o xxx.md  --\u003e\n\n# Pandoc Thesis Template\n\nA template for thesis documents written in Markdown.\n\n## About\n\nThis template makes it easy to write your thesis in Markdown. It uses an integrated toolchain\nto translate your work into LaTeX, creating a properly formatted PDF document. So you don't\nhave to worry about the somewhat arcane TeX commands and you can still enjoy the centuries-old\nart of letterpress printing, with its rules integrated into LaTeX.\n\nYou can choose between two different styles:\n\n-   'simple'\n\n    The 'Simple' theme uses the [scrbook LaTeX class] and adds a custom title page.\n\n-   'Eisvogel'\n\n    The 'Eisvogel' style is based on the [Eisvogel LaTeX template] and adds a back page for\n    the cover sheet with all the information you need for a thesis.\n\nBoth styles let you add an acknowledgement, an abstract (in German and/or English) and a\nrestriction note.\n\n## Prerequisites\n\nThere are two different ways you can start with this template:\n\n1.  Working **locally** on your own machine:\n\n    You will need [Docker] and the [`pandoc/extra`] docker image, as well as the contents of\n    this [template repository] plus [GNU Make].\n\n    \u003cdetails\u003e\n\n    -   Fork this repository into your own namespace\n\n        Here's a tip: If you don't need the history or future update, just click the '*Use\n        this template*' button above!\n\n    -   *Git clone* your repository locally to your machine\n\n    -   Install [Docker]\n\n    -   Fetch the [`pandoc/extra`] docker image containing all dependencies, e.g. pandoc and\n        TeX Live: `make docker` or `docker pull pandoc/extra:latest-ubuntu`\n\n        **Note**: You will need about 1.5GB of free disk space:\n\n            $ docker image ls\n            REPOSITORY       TAG             IMAGE ID       CREATED       SIZE\n            pandoc/extra     latest-ubuntu   4be5559759ed   6 weeks ago   1.27GB\n\n    -   Work on the [`thesis.md`] and [`references.bib`] files to create your thesis and build\n        the PDF using `make simple` or `make eisvogel` (see below)\n\n    \u003c/details\u003e\n\n2.  Working **remote** using GitHub workflows:\n\n    Maintain a repository with the two relevant files [`thesis.md`] and [`references.bib`],\n    and use a GitHub workflow to build the PDF.\n\n    \u003cdetails\u003e\n\n    -   Either fork this repository into your own namespace or create your own repository\n        containing copies of both the [`thesis.md`] and [`references.bib`] files provided here\n\n    -   Create a GitHub workflow in your repository using the GitHub action\n        `cagix/pandoc-thesis` that is included in this template, e.g.:\n\n        ``` yaml\n        on:\n          pull_request:\n\n        jobs:\n          compile:\n            runs-on: ubuntu-latest\n            steps:\n              - uses: actions/checkout@v4\n              - uses: cagix/pandoc-thesis@master\n                with:\n                  srcfile: thesis.md\n                  targetfile: thesis.pdf\n                  bibfile: references.bib\n                  template: eisvogel\n              - uses: actions/upload-artifact@v4\n                with:\n                  path: thesis.pdf\n                  overwrite: true\n        ```\n\n        Please adjust the file names as needed.\n\n    -   Work on the [`thesis.md`] and [`references.bib`] files to create your thesis and build\n        the PDF by pushing to your repository (see below)\n\n    \u003c/details\u003e\n\n## Working with this template\n\n1.  Maintain your references in [`references.bib`] (BibTeX format)\n\n    There are many reference management programs offering BibTeX export. A nice example is\n    [JabRef], which allows you to create and maintain your BibTeX file locally.\n\n2.  Put the **title** of your thesis, your **name** and other meta information into the YAML\n    header of [`thesis.md`]\n\n3.  Adjust optional definitions in the YAML header of [`thesis.md`] to your needs:\n\n    -   Disable extras like `abstract-*` or `acknowledgements` or `restrictionnote`: Remove or\n        comment this optional definitions\n    -   Modify content (text) of optional definitions like `abstract-*` or `acknowledgements`\n        or `restrictionnote`\n\n4.  Put your content into the markdown file [`thesis.md`]\n\n    The default chapters correspond to a typical structure of a scientific thesis (see also\n    `@Balzert2022`: *Balzert et al.* \"Wissenschaftliches Arbeiten\", 2022). You can just use\n    this as starting point for your work ...\n\n    *Hint*: You will find some help regarding the use of Markdown in the first chapter of\n    [`thesis.md`] as well as typical number of pages for each chapter in the beginning of each\n    chapter.\n\n5.  Pandoc uses per default the *Chicago Manual of Style* for citations\n    (cf. [pandoc.org/MANUAL.html#citations]).\n\n    You can search [zotero.org/styles] or [editor.citationstyles.org/searchByName] for\n    alternative style definitions, download the corresponding `.csl` file to your project\n    folder and activate the style in the corresponding default file, i.e. [`eisvogel.yaml`] or\n    [`simple.yaml`] (option `csl: XXX.csl` at the bottom of the file).\n\n6.  Build the thesis:\n\n    -   Locally:\n        -   Simple layout: `make simple`\n        -   Eisvogel theme: `make eisvogel`\n    -   Remote:\n        -   `git push` (and let your GitHub workflow do the heavy lifting)\n\n7.  Clean up (when working locally):\n\n    -   To remove temporary (generated) filed: `make clean`\n    -   To also remove the generated thesis (PDF): `make distclean`\n\n\u003e [!WARNING]\n\u003e When switching between templates, please make sure to `make clean` first! Failing to do so\n\u003e may lead to strange behaviour or even to weird errors.\n\n\u003e [!IMPORTANT]\n\u003e Do not use Windows + Docker directly, but via WSL:\n\u003e\n\u003e -   Install WSL (see https://learn.microsoft.com/en-us/windows/wsl/install), any\n\u003e     distribution will work\n\u003e -   Start the subsystem to get access to its shell\n\u003e -   `git clone https://github.com/cagix/pandoc-thesis.git` to pull the project\n\u003e -   `make docker` to pull the `pandoc/extra` image\n\u003e -   `make simple` or `make eisvogel` to build the thesis\n\u003e -   Success!\n\n## Submitting your thesis\n\nHSBI students submit their work as a PDF using the upload form at\nhttps://www.hsbi.de/hochschule/schriftliche-arbeiten.\n\nA declaration of originality must also be submitted. The form can be found at\n[\"Eigenständigkeitserklärung\"] and must be completed, signed and uploaded together with the\nthesis PDF.\n\n## Preview\n\n### Example using *Simple* Layout\n\n| Simple Titlepage         | Simple Chapter         |\n|--------------------------|------------------------|\n| [![Simple Titlepage]][1] | [![Simple Chapter]][1] |\n\n### Example using *Eisvogel* Template\n\n| Eisvogel Titlepage         | Eisvogel Chapter         |\n|----------------------------|--------------------------|\n| [![Eisvogel Titlepage]][2] | [![Eisvogel Chapter]][2] |\n\n----------------------------------------------------------------------------------------------\n\n# License\n\nThis work by [Carsten Gips] and [contributors] is licensed under [MIT].\n\n  [scrbook LaTeX class]: https://ctan.org/pkg/scrbook\n  [Eisvogel LaTeX template]: https://github.com/Wandmalfarbe/pandoc-latex-template\n  [Docker]: https://www.docker.com/\n  [`pandoc/extra`]: https://hub.docker.com/r/pandoc/extra/\n  [template repository]: https://github.com/cagix/pandoc-thesis\n  [GNU Make]: https://www.gnu.org/software/make/\n  [`thesis.md`]: thesis.md\n  [`references.bib`]: references.bib\n  [JabRef]: https://www.jabref.org/\n  [pandoc.org/MANUAL.html#citations]: https://pandoc.org/MANUAL.html#citations\n  [zotero.org/styles]: https://www.zotero.org/styles\n  [editor.citationstyles.org/searchByName]: https://editor.citationstyles.org/searchByName/\n  [`eisvogel.yaml`]: ./eisvogel.yaml\n  [`simple.yaml`]: ./simple.yaml\n  [\"Eigenständigkeitserklärung\"]: https://www.hsbi.de/media/hochschulverwaltung/dezernat-ii/studserv/pruefungsangelegenheiten/hochschulweite-ordnungen-formulare-und-antraege/eigenstaendigkeitserklaerung\n  [Simple Titlepage]: examples/thesis_example_simple_titlepage.png\n  [1]: examples/thesis_example_simple.pdf\n  [Simple Chapter]: examples/thesis_example_simple_chapter.png\n  [Eisvogel Titlepage]: examples/thesis_example_eisvogel_titlepage.png\n  [2]: examples/thesis_example_eisvogel.pdf\n  [Eisvogel Chapter]: examples/thesis_example_eisvogel_chapter.png\n  [Carsten Gips]: https://github.com/cagix\n  [contributors]: https://github.com/cagix/pandoc-thesis/graphs/contributors\n  [MIT]: https://opensource.org/licenses/MIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcagix%2Fpandoc-thesis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcagix%2Fpandoc-thesis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcagix%2Fpandoc-thesis/lists"}