Documents, Distributions, and Collaborative Writing
17 June 2026
Tip
No prior LaTeX experience required. We start from scratch. Session 2 covers thesis document structure, Quarto, TikZ, and advanced bibliography management.
LaTeX is a document preparation system based on plain-text markup.
.tex file — LaTeX compiles it to PDFNote
LaTeX is not a word processor. You never see the final layout while typing — you compile to see the result.
Every LaTeX document has two parts: the preamble and the body.
\documentclass[12pt,a4paper]{article} % document class + options
% --- Preamble: load packages and configure settings ---
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[english]{babel}
\usepackage{amsmath}
\usepackage{graphicx}
\title{My Paper}
\author{Jane Doe}
\date{\today}
% --- Body: the typeset content ---
\begin{document}
\maketitle
\tableofcontents
\section{Introduction}
Text goes here.
\end{document}\documentclass sets the layout template (article, report, book, beamer …)\usepackage{name}\begin{document} and \end{document} is compiledCommands start with a backslash and take optional […] and required {…} arguments:
Environments wrap a block of content between \begin{name} and \end{name}:
Comments begin with % and are ignored by the compiler:
Tip
The most common beginner mistake is forgetting \end{name} to close an environment.
Inline formatting:
| Syntax | Result |
|---|---|
\textbf{text} |
bold |
\textit{text} |
italic |
\underline{text} |
underlined |
\texttt{text} |
monospace |
\emph{text} |
context-sensitive emphasis |
Sectioning commands:
Lists:
LaTeX’s math typesetting is unmatched among document preparation tools.
Inline math — wrap in $…$:
Display math — \[…\] or equation for a numbered equation:
Common symbols:
| Syntax | Symbol |
|---|---|
\alpha, \beta, \gamma |
α β γ |
\frac{a}{b} |
fraction |
x^{2}, x_{i} |
superscript, subscript |
\sum, \int, \infty |
Σ ∫ ∞ |
Tip
The amsmath package adds align, cases, and pmatrix environments for complex expressions.
Inserting a figure:
A simple table:
Cross-references — \label to mark, \ref to cite:
LaTeX resolves all numbers automatically — renumbering never breaks references.
Note
[htbp] tells LaTeX where to place the float: here, top, bottom, or a separate page.
Consistent, professional typography — automatically
Designed for complex documents
Plain text — version-control friendly
.tex files are plain text: diff them, track them in Git, collaborate via pull requestsTip
Source: LaTeX/Introduction — Wikibooks
LaTeX integrates well with reproducible research workflows:
| Approach | How it works |
|---|---|
| Plain LaTeX | Write .tex by hand; import figures from separate scripts |
| R Markdown | Mix R code and LaTeX-style text; compile to PDF via LaTeX |
| Quarto | Successor to R Markdown; supports Python, R, Julia; PDF output via LaTeX |
| Jupyter + LaTeX | Figures generated in a notebook; imported into the .tex manuscript |
Note
For fully reproducible manuscripts, literate programming tools (R Markdown, Quarto) are often preferred over plain .tex files — they keep the analysis and the document in one place.
“The Not So Short Introduction to LaTeX” (lshort)
lshort started as a translation and rationalisation of a ground-breaking German-language introduction to LaTeX. It has since taken on a momentum of its own, and has itself been translated into a number of languages.
Tip
Download or read online: https://www.ctan.org/pkg/lshort
“LaTeX for Novices: Academic Publishing”
from the Rhine-Ruhr Center for Scientific Data Literacy (DKZ.2R)
| Resource | Link |
|---|---|
| Lesson website | dkz2r.github.io/latex-novice-academic-publishing |
| Source on GitHub | github.com/dkz2r/latex-novice-academic-publishing |
| Past workshops | dkz2r.de/tags/latex |
Note
Today’s hands-on section follows this workshop’s materials. You can work through the full lesson at your own pace after today.
Reference documentation
Quick lookup
Tip
When you get a LaTeX error, copy the error message into a search engine together with “tex stackexchange” — there is almost always a thread with a working answer.
Overleaf is a web-based LaTeX editor with real-time collaboration.
At the University of Cologne — via Sciebo:
| Launch Overleaf via Sciebo | uni-koeln.sciebo.de → Apps → Overleaf |
| Sciebo Overleaf documentation | docs.sciebo.de → Apps → Overleaf |
Note
The Sciebo-linked Overleaf instance keeps your files on university infrastructure. Files are stored in your Sciebo (Nextcloud) account, not on Overleaf’s servers.
A LaTeX distribution bundles the compiler, packages, and fonts you need to compile .tex files locally.
| Distribution | Platform | Notes |
|---|---|---|
| TeX Live | Linux, macOS, Windows | Most complete; strongly recommended by the VS Code LaTeX extension |
| MiKTeX | Windows (also Linux/macOS) | Installs missing packages on the fly; lighter initial install |
| TinyTeX | Windows, Linux, macOS | Minimal, R-friendly; install from R with tinytex::install_tinytex() |
Which should I use?
Tip
If you are unsure, install TeX Live — it is the most complete and avoids missing-package errors.
Before choosing an editor, it is worth being honest about why many researchers avoid local LaTeX altogether.
Common complaints (from practitioners):
“LaTeX is such a nightmare to work with locally.”
“Just install LaTeX is really not a valid response when the LaTeX toolchain is a genuine nightmare to work with.”
Web-based editors solve most of this:
Note
Using Overleaf, Prism, or TeXlyre is not a compromise — for many workflows it is the right first choice.
You can write LaTeX in any text editor, but dedicated tools add compilation, preview, and autocomplete.
| Editor | Type | Best for |
|---|---|---|
| Overleaf | Web-based | Collaboration; most popular in academia |
| Prism (OpenAI) | Web-based, AI-native | AI-assisted writing, citations, proofreading; free |
| TeXlyre | Web-based, open-source | Privacy-first; offline; self-hostable; real-time collaboration |
| TeXstudio | Desktop | Dedicated LaTeX GUI; built-in PDF viewer |
| VS Code + LaTeX Workshop | Desktop + extension | Researchers already using VS Code |
Note
All web-based editors require no local LaTeX installation. For local editing, VS Code + LaTeX Workshop or TeXstudio both work well with TeX Live.
Prism is OpenAI’s free, cloud-based LaTeX editor designed for scientific writing.
Key features:
Tip
Start writing at prism.openai.com — no local installation needed.
TeXlyre is a free, open-source, browser-based LaTeX and Typst editor with a strong focus on privacy and offline capability.
Key features:
| Try online | texlyre.github.io/texlyre |
| Source code | github.com/TeXlyre/texlyre |
| License | AGPL-3.0 (funded by NLnet / NGI0 Commons Fund) |
VS Code + LaTeX Workshop is a powerful local setup for researchers already using VS Code.
lacheck / chktex; auto-formatter via latexindentInstall guide: github.com/James-Yu/LaTeX-Workshop/wiki/Install
Note
LaTeX Workshop requires a local TeX Live (or MiKTeX) installation to compile documents.
LaTeX is the standard in many fields, but other tools are worth knowing:
| Tool | Type | Notes |
|---|---|---|
| Typst | Markup → PDF | Modern typesetting language; much faster compilation; growing package ecosystem; simpler syntax than LaTeX |
| Quarto / MyST | Literate programming | R, Python, Julia code + prose in one file; PDF via LaTeX; ideal for reproducible research |
| Lattics | Writing app | Markdown-based academic writing environment; knowledge graph for literature notes |
| Obsidian | Knowledge management | Markdown; excellent for note-taking and literature review; not a publishing tool |
| Typora | Markdown editor | Clean live-preview Markdown editor; limited support for complex academic formatting |
Tip
Typst is the most direct LaTeX alternative for new documents. Quarto is often the better choice for researchers who run analysis code alongside their writing.
latexindent — automatic formatting for .tex files
Other useful utilities
| Tool | Purpose |
|---|---|
biber / BibTeX |
Bibliography management; processes .bib files |
makeindex / xindy |
Generates indices |
latexmk |
Automates the multi-pass compilation process |
pdftk / ghostscript |
Post-processing and merging PDF output |
Tip
TeX Live includes most of these tools by default — you rarely need to install them separately.
LaTeX handles bibliographies through external tools. Two key tools in the academic workflow:
Zotero — reference manager
BetterBibTeX — seamless LaTeX integration
.bib fileschepens2024prominence).bib file regenerates automatically; your LaTeX project always has fresh referencesNote
Session 2 covers the full BetterBibTeX workflow, .bib file structure, biblatex/biber, and citation commands in depth.
The opportunity
LaTeX’s plain-text format makes it unusually well-suited for AI assistance:
.tex directly — something not possible with binary word-processor formatsThe concern — an editor’s perspective
AI writing tools also lower the barrier to submitting scientifically empty manuscripts:
“From my perspective as a journal editor, these tools cause many more problems than they solve. A significant fraction of submissions are now vibe-written and come from folks looking to boost their CV — this just wastes already-stretched reviewer time.”
“The hard part always has been, and always will be, understanding the research context and producing novel and interesting work. Connecting this together in a paper is a learnable skill, but it is really a minimal part of the process.”
A useful distinction for workshop participants:
| Use of AI | Assessment |
|---|---|
| Fix a LaTeX error, reformat a table | Generally fine |
| Improve clarity of your own text | Fine with care |
| Generate scientific content, arguments, or citations | Problematic |
The next workshop builds on today’s foundations:
| Topic | What you will learn |
|---|---|
| Thesis document structure | \input, \include, multi-file projects, report/book class |
| Bibliography deep dive | .bib files, biblatex, biber, citation commands |
| Zotero + BetterBibTeX | Auto-export, cite keys, keeping references in sync |
| Quarto | Literate programming: R/Python + LaTeX in a single source file |
| TikZ | Programmatic vector figures and diagrams directly in LaTeX |
| Templates | Journal submission files; university thesis templates |
| Debugging | Reading error messages; common pitfalls |
Tip
All materials will be posted at dkz2r.de/tags/latex after the workshop.
Work through the DKZ.2R lesson at dkz2r.github.io/latex-novice-academic-publishing:
Step 1 — Set up your editor (choose one):
main.texStep 2 — Write a minimal document:
Step 3 — Compile and explore:
Tip
Stuck? Check tex.stackexchange.com or ask — most errors have a known fix.
Concepts
Practical choices
| Goal | Recommendation |
|---|---|
| AI-assisted writing; free | Prism (OpenAI) |
| Privacy-first / offline | TeXlyre |
| Sciebo integration | Overleaf via Sciebo |
| Local + VS Code | TeX Live + LaTeX Workshop |
| R / Quarto | TinyTeX |
| Dedicated LaTeX GUI | TeXstudio |
Note
Start here: dkz2r.github.io/latex-novice-academic-publishing
RDM Workshop Series · SFB 1252 Prominence in Language · Universität zu Köln