# Zettlr Setup Guide

URL: https://research-memex.org/docs/implementation/foundational-setup/zettlr-setup-guide
Description: Zettlr gives long-form academic drafts a plain-text home while keeping citations and export paths intact.



<GuideMeta>
  Intermediate · 45–60 min · Zotero with Better BibTeX configured
</GuideMeta>

*Drafting is where scattered ideas become a coherent argument.*

## Overview [#overview]

Zettlr is the drafting tool in this workflow, built for linear academic manuscripts with citations and export paths.

Benefits for Research Memex users:

* `@citekey` autocomplete using your Better BibTeX citation keys from Zotero
* LaTeX math formulas rendered in real time
* Visual table editor for results and comparisons
* Export to Word, PDF, and LaTeX for journal submission
* Projects for organizing multi-chapter documents
* Open source with no vendor lock-in

## When to use Zettlr vs Obsidian [#when-to-use-zettlr-vs-obsidian]

Both tools open the same plain markdown files, so you can move between them at
any point. This is about where a task is comfortable, not about what either one
can do.

| Task                                                             | Reach for |
| ---------------------------------------------------------------- | --------- |
| Daily research notes, literature notes from Zotero               | Obsidian  |
| Connecting ideas across papers, synthesis and theory development | Obsidian  |
| AI conversation exports                                          | Obsidian  |
| Drafting a journal article or dissertation chapter               | Zettlr    |
| Papers with heavy citations (20+ refs)                           | Zettlr    |
| Documents with math formulas                                     | Zettlr    |
| Complex tables                                                   | Zettlr    |
| Exporting to Word, PDF, or LaTeX for submission                  | Zettlr    |

Typical workflow:

```
Zotero          Research Rabbit      Obsidian           Zettlr           Journal
(References) →  (Discovery)      →   (Synthesis)    →   (Drafting)   →   (Submission)
                                     [Web of notes]     [Linear paper]
```

## Step 1: install Zettlr [#step-1-install-zettlr]

### 1.1 download and install [#11-download-and-install]

1. Visit [zettlr.com/download](https://www.zettlr.com/download)
2. Download for your operating system (macOS, Windows, Linux)
3. Install the application
4. Launch Zettlr

### 1.2 first launch configuration [#12-first-launch-configuration]

<Aside label="Folder choice">
  Create a dedicated folder like `/Research-Papers/` separate from your Obsidian vault. This keeps research notes (Obsidian) distinct from paper drafts (Zettlr).
</Aside>

1. Choose a workspace folder (can be the same as your Obsidian vault or separate)
2. Select your preferred theme (Light or Dark)
3. Configure editor settings (line numbers, spellcheck language)

## Step 2: connect to Zotero [#step-2-connect-to-zotero]

This step connects Zettlr to your Zotero library through Better BibTeX.

### 2.1 export Better BibTeX library from Zotero [#21-export-better-bibtex-library-from-zotero]

<Aside label="Auto-sync">
  With "Keep updated" checked, Zotero updates this file whenever you add papers. Zettlr can then use your latest references.
</Aside>

1. In Zotero: File → Export Library
2. Format: **Better CSL JSON** (recommended) or **Better BibTeX**
3. Check: "Keep updated" (auto-sync when library changes)
4. Save location: Choose a stable location like:
   ```
   /Users/[username]/Zotero/exports/My-Library.json
   ```
5. Click OK

### 2.2 configure citation database in Zettlr [#22-configure-citation-database-in-zettlr]

1. In Zettlr: Preferences → Export
2. Under "Citation Database":
   * Click "Add Database"
   * Navigate to your exported library file (e.g., `My-Library.json`)
   * Click "Open"
3. Verify: You should see the database path listed

### 2.3 test citation autocomplete [#23-test-citation-autocomplete]

<Aside>
  With Better BibTeX's `[auth:lower][year]` pattern, keys look like `smith2024a`. Use the same keys in Zotero, Obsidian, and Zettlr.
</Aside>

1. Create a new file in Zettlr
2. Type `@` followed by a few letters from any author's last name
3. You should see autocomplete suggestions!
4. Select a citation → it inserts as `[@smith2024a]`

### 2.4 configure citation style [#24-configure-citation-style]

1. Preferences → Export → Citation Style
2. Default is Chicago style
3. To change: Download .csl file from [Citation Style Language](https://citationstyles.org/)
4. Common academic styles:
   * APA 7th edition
   * MLA 9th edition
   * Harvard
   * IEEE
   * Nature
   * Your journal's specific style

## Step 3: core writing features [#step-3-core-writing-features]

### 3.1 citations with @citekey [#31-citations-with-citekey]

Basic citation syntax:

* Parenthetical: `[@smith2024a]` → (Smith, 2024)
* In-text: `@smith2024a` → Smith (2024)
* With page: `[@smith2024a, p. 45]` → (Smith, 2024, p. 45)
* Multiple: `[@smith2024a; @jones2024b]` → (Smith, 2024; Jones, 2024)

Autocomplete features:

* Type `@` and start typing author name
* Use fuzzy search (type `@smi` to find Smith, Smithers, etc.)
* Press arrow keys to select and Enter to insert
* Bibliography auto-generates in preview

Example workflow:

```markdown
As @coviello2024 argues, organizational scaling requires...

However, this view has been contested [@mithani2023; @sanasi2025],
particularly regarding digital business models.

The framework proposed in [@palmie2023, pp. 234-236] suggests...
```

### 3.2 math formulas with LaTeX [#32-math-formulas-with-latex]

Inline math:

```markdown
The regression model is $y = \beta_0 + \beta_1 x + \epsilon$
```

Display math:

```markdown
$$
\begin{aligned}
E[Y|X] &= \beta_0 + \beta_1 X \\
R^2 &= 1 - \frac{SS_{res}}{SS_{tot}}
\end{aligned}
$$
```

Common use cases:

* Statistical models
* Economic equations
* Mathematical proofs
* Chemical formulas
* Algorithmic notation

Zettlr renders LaTeX math in real time, which makes equations easier to check while drafting in Markdown.

### 3.3 visual table editor [#33-visual-table-editor]

1. Click the "Insert Table" button (or Cmd/Ctrl+T)
2. Select grid size (rows × columns)
3. Edit cells directly - Tab to navigate
4. Right-click for options:
   * Add/remove rows
   * Add/remove columns
   * Align columns (left/center/right)

Example use case:

```markdown
| Model | AIC | BIC | R² |
|-------|-----|-----|-----|
| Model 1 | 245.3 | 267.8 | 0.42 |
| Model 2 | 238.1 | 264.9 | 0.51 |
```

### 3.4 comments for drafting [#34-comments-for-drafting]

Add Hidden Notes:

```markdown
This section discusses the methodology. <!-- Example: TODO reminder for later revision -->

Our findings suggest that... <!-- Example: Check citation against source -->
```

Keyboard shortcut: Cmd/Ctrl+Shift+C

Use cases:

* Leave notes to yourself
* Mark sections for revision
* Hide text temporarily without deleting
* Add reviewer responses (invisible in export)

## Step 4: projects for long documents [#step-4-projects-for-long-documents]

Projects help you organize dissertations, book chapters, or multi-section papers.

### 4.1 create a project [#41-create-a-project]

1. Create a folder structure:
   ```
   /My-Dissertation/
   ├── 01-Introduction.md
   ├── 02-Literature-Review.md
   ├── 03-Methodology.md
   ├── 04-Results.md
   ├── 05-Discussion.md
   └── 06-Conclusion.md
   ```

2. Right-click the folder → Properties

3. Check "Treat as project"

4. Folder turns red with special icon

### 4.2 configure project export [#42-configure-project-export]

1. Click the folder
2. Configure:
   * Title page information
   * Export formats (PDF, DOCX, etc.)
   * Table of contents settings
   * Bibliography options

### 4.3 compile your paper [#43-compile-your-paper]

1. Right-click project folder → Export Project
2. Zettlr concatenates all files in order
3. Generates single output with:
   * Proper citations
   * Formatted bibliography
   * Table of contents
   * Page numbers

Work on dissertation chapters separately, using Obsidian for research and Zettlr for drafting, then compile them into one document.

## Step 5: export workflow [#step-5-export-workflow]

### 5.1 export to PDF (via LaTeX) [#51-export-to-pdf-via-latex]

Prerequisites:

* LaTeX distribution installed (MacTeX, MiKTeX, or TeX Live)

Steps:

1. Cmd/Ctrl+E or click "Share" icon
2. Choose "PDF (LaTeX)"
3. First export may take time (downloading packages)
4. Result: Professional PDF with formatted bibliography

### 5.2 export to Word (.docx) [#52-export-to-word-docx]

No LaTeX required:

1. Cmd/Ctrl+E → "Word (docx)"
2. Opens in Microsoft Word or compatible app
3. Citations formatted according to CSL style
4. Bibliography auto-generated at end

Use cases:

* Journal submissions requiring Word
* Collaboration with non-markdown users
* Track changes and comments in Word

### 5.3 export to LaTeX source [#53-export-to-latex-source]

For advanced users:

1. Export → "LaTeX"
2. Generates .tex file
3. Compile with your own LaTeX editor
4. Full control over LaTeX formatting

### 5.4 configure export settings [#54-configure-export-settings]

Preferences → Export:

* **Paper size**: A4 or Letter
* **Font**: Choose academic font (Times, Palatino)
* **Line spacing**: 1.5 or 2.0 for drafts
* **Bibliography style**: Select your .csl file
* **Remove ZKN IDs**: Check this for clean output

## Step 6: integration with Research Memex workflow [#step-6-integration-with-research-memex-workflow]

### 6.1 from Obsidian to Zettlr [#61-from-obsidian-to-zettlr]

Scenario: You've synthesized findings in Obsidian. Now write the paper.

Workflow:

1. In Obsidian: Create synthesis notes with main arguments
2. Copy to Zettlr: Create new .md file for paper section
3. Transform: Convert bullet points → paragraphs
4. Add citations: Use @citekey for every claim
5. Export: Generate PDF/Word when ready

Example:

```markdown
<!-- In Obsidian (synthesis note) -->
## Key Theme: Scaling requires both strategy and structure
- Coviello 2024: Distinguishes scalability from scaling
- Mithani 2023: Digital vs non-digital models differ
- Sanasi 2025: Experimentation structures growth

<!-- In Zettlr (paper draft) -->
The literature reveals that successful scaling requires both
strategic vision and organizational structure [@coviello2024].
This is particularly evident in the distinction between digital
and non-digital business models [@mithani2023], where the role
of experimentation differs significantly [@sanasi2025].
```

### 6.2 from AI conversations to structured sections [#62-from-ai-conversations-to-structured-sections]

1. Export Cherry Studio conversations to markdown
2. Review AI-generated synthesis
3. Copy useful passages to Zettlr
4. Add proper citations. AI can hallucinate these.
5. Verify every claim against your Zotero library

<Warning>
  AI-generated text often includes plausible-sounding citations that do not exist. Always verify using @citekey autocomplete. If the citation does not autocomplete, it is not in your library.
</Warning>

### 6.3 Zotero → Zettlr direct citations [#63-zotero--zettlr-direct-citations]

No copy-paste needed:

1. Know your citation key from Zotero (e.g., `smith2024a`)
2. In Zettlr: Type `@smith` → autocomplete suggests it
3. Select → inserts `[@smith2024a]`
4. Export → bibliography auto-generated

## Step 7: best practices [#step-7-best-practices]

### 7.1 when to switch from Obsidian to Zettlr [#71-when-to-switch-from-obsidian-to-zettlr]

The trigger is a clear paper outline: once the argument has a shape and you are
ready to draft linear sections, move the draft over. The task-by-task split is
at [When to use Zettlr vs Obsidian](#when-to-use-zettlr-vs-obsidian).

### 7.2 file organization strategy [#72-file-organization-strategy]

Recommended Structure:

```
/Research-Papers/
├── Drafts/
│   ├── Paper-2025-Scaling/
│   │   ├── 01-Introduction.md
│   │   ├── 02-Literature.md
│   │   ├── 03-Methods.md
│   │   └── ...
│   └── Dissertation/
│       ├── Chapter-1-Introduction/
│       └── Chapter-2-Theory/
├── Submitted/
└── Published/
```

### 7.3 version control with git [#73-version-control-with-git]

Zettlr files are plain markdown, which makes them suitable for Git.

Workflow:

```bash
cd /Research-Papers/Paper-2025-Scaling/
git init
git add *.md
git commit -m "Initial draft of introduction"
```

Benefits:

* Track every revision
* Revert to earlier versions
* Collaborate via GitHub
* Never lose work

### 7.4 collaborative writing [#74-collaborative-writing]

Option 1: Git-Based (Technical)

* Push to GitHub private repo
* Collaborators pull, edit, push
* Merge changes
* Requires Git knowledge

Option 2: Export to Word (Simple)

* Export to .docx
* Share via email/cloud
* Collaborators use Track Changes
* Import revisions back to markdown

## Step 8: keyboard shortcuts for speed [#step-8-keyboard-shortcuts-for-speed]

Essential shortcuts:

* `Cmd/Ctrl+E`: Export document
* `Cmd/Ctrl+B`: Bold
* `Cmd/Ctrl+I`: Italic
* `Cmd/Ctrl+K`: Insert link
* `Cmd/Ctrl+Shift+C`: Insert comment
* `Cmd/Ctrl+T`: Insert table
* `Cmd/Ctrl+F`: Search
* `Cmd/Ctrl+R`: Replace

Citation Shortcuts:

* Type `@` → Citation autocomplete
* Type `#` → Headings
* Type `$` → Inline math
* Type `$$` → Display math

## Step 9: advanced features [#step-9-advanced-features]

### 9.1 zettelkasten IDs (optional) [#91-zettelkasten-ids-optional]

Zettlr supports Zettelkasten-style linking:

* Format: `[[202501151420]]` (timestamp-based IDs)
* Auto-generated with Cmd/Ctrl+L to create a unique identifier for each note

<Aside label="SKIP THIS">
  Most Research Memex users won't need this: we use Better BibTeX citation keys instead.
</Aside>

### 9.2 custom CSS for styling [#92-custom-css-for-styling]

1. Preferences → Display → Custom CSS
2. Add custom styles for preview
3. Example: Change heading colors, font sizes, etc.

### 9.3 snippet manager [#93-snippet-manager]

Create reusable text snippets:

1. Preferences → Snippets
2. Add snippets with shortcuts
3. Examples:
   * `@@email` → your email address
   * `@@affiliation` → your institution
   * `@@template` → paper template structure

## Step 10: troubleshooting [#step-10-troubleshooting]

### Citation library not loading [#citation-library-not-loading]

Symptoms: @citekey autocomplete doesn't work

Solutions:

* Verify library path in Preferences → Export
* Check file format (must be CSL JSON or BibTeX)
* Re-export from Zotero with "Keep updated"
* Restart Zettlr

### Export to PDF fails [#export-to-pdf-fails]

Symptoms: "LaTeX not found" error

Solutions:

* Install LaTeX distribution:
  * macOS: MacTeX (4GB) or BasicTeX (100MB)
  * Windows: MiKTeX
  * Linux: TeX Live
* Or export to Word instead (no LaTeX needed)

### Bibliography not appearing [#bibliography-not-appearing]

Symptoms: Citations work but no bibliography at end

Solutions:

* Ensure citation style (.csl) is selected
* Check that you have at least one citation in the document
* Try exporting to different format
* Verify Better BibTeX export is up-to-date

### Math formulas not rendering [#math-formulas-not-rendering]

Symptoms: LaTeX math shows as plain text

Solutions:

* Check syntax: no spaces after `$` in inline math
* Verify you're in preview mode (Cmd/Ctrl+Alt+E)
* Test with simple formula: `$x^2$`
* Check KaTeX documentation for supported commands

## Integration with Research Memex workflow [#integration-with-research-memex-workflow]

### Complete workflow example [#complete-workflow-example]

Phase 1: Research (Weeks 1-4)

* Zotero: Collect 50+ papers, configure Better BibTeX
* Research Rabbit: Expand citation network
* Obsidian: Take literature notes, synthesize themes

Phase 2: Analysis (Weeks 5-8)

* Cherry Studio: Pattern analysis with AI support
* Obsidian: Build conceptual framework
* Zotero: Refine collection, verify citations

Phase 3: Writing (Weeks 9-12)

* Zettlr: Draft paper sections
  * Use @citekey for every claim
  * Add math formulas where needed
  * Build results tables
* Export: Generate PDF for advisor review

Phase 4: Revision (Weeks 13-16)

* Zettlr: Incorporate feedback
  * Use comments for tracking changes
  * Update citations
  * Refine arguments
* Export: Final submission to journal

### Tool handoff points [#tool-handoff-points]

From Obsidian to Zettlr:

1. Identify completed synthesis notes in Obsidian
2. Create new Zettlr file for paper section
3. Copy main arguments and evidence
4. Transform from notes → prose
5. Add proper citations with @citekey

From Zettlr back to Obsidian:

1. Export Zettlr paper to markdown
2. Save in Obsidian vault for archiving
3. Link to related research notes
4. Track published work

## Checklist [#checklist]

By the end of this guide, you should have:

* [ ] Installed Zettlr
* [ ] Connected to Zotero Better BibTeX library
* [ ] Tested @citekey autocomplete
* [ ] Configured citation style (e.g., APA, MLA)
* [ ] Created a test document with citations
* [ ] Inserted a math formula (if needed)
* [ ] Created a table
* [ ] Exported to PDF or Word successfully
* [ ] (Optional) Created a project for multi-file paper
* [ ] (Optional) Installed LaTeX for PDF export

<Tip>
  Quick Test: Create a file with this content and export to PDF:

  ```markdown
  # Test Paper

  As @[yourcitekey] demonstrates, the methodology...

  The model is: $y = \beta x + \epsilon$

  ## References
  (Auto-generated)
  ```

  If the bibliography appears at the end, the setup works.
</Tip>

## Quick reference [#quick-reference]

Task split: [When to use Zettlr vs Obsidian](#when-to-use-zettlr-vs-obsidian).

### Essential keyboard shortcuts [#essential-keyboard-shortcuts]

<KeyTable column="2">
  | Action          | Shortcut         |
  | --------------- | ---------------- |
  | Export          | Cmd/Ctrl+E       |
  | Insert citation | Type `@`         |
  | Insert comment  | Cmd/Ctrl+Shift+C |
  | Insert table    | Cmd/Ctrl+T       |
  | Bold            | Cmd/Ctrl+B       |
  | Italic          | Cmd/Ctrl+I       |
  | Search          | Cmd/Ctrl+F       |
  | Toggle preview  | Cmd/Ctrl+Alt+E   |
</KeyTable>

## Resources [#resources]

### Zettlr documentation [#zettlr-documentation]

* [Citation Guide](https://docs.zettlr.com/en/editor/citations/)
* [Tables](https://docs.zettlr.com/en/editor/tables/)
* [Math Formulas](https://docs.zettlr.com/en/scientific-technical/math/)
* [Projects](https://docs.zettlr.com/en/file-manager/projects/)
* [Exporting](https://docs.zettlr.com/en/export/)
* [Writing Markdown in Zettlr](https://docs.zettlr.com/en/first-time-users/writing-markdown/)
* [File Renaming (Zotero)](https://www.zotero.org/support/file_renaming)

### Integration with other tools [#integration-with-other-tools]

* [Zotero Setup Guide](/docs/implementation/foundational-setup/zotero-setup-guide) - Configure Better BibTeX citation keys
* [Obsidian Setup Guide](/docs/implementation/foundational-setup/obsidian-setup-guide) - Research note-taking
* [Cherry Studio Setup Guide](/docs/implementation/agentic-ai-tools/cherry-studio-setup-guide) - Pattern analysis with AI support

### External resources [#external-resources]

* [Citation Style Language](https://citationstyles.org/) - Download .csl files for any journal
* [Pandoc Documentation](https://pandoc.org/) - Zettlr's export engine
* [KaTeX Documentation](https://katex.org/) - Math formula reference
* [Zettlr Forum](https://forum.zettlr.com/) - Community support

## Common questions [#common-questions]

Q: Should I use Zettlr OR Obsidian?
A: Both - they complement each other. The task split is at [When to use Zettlr vs Obsidian](#when-to-use-zettlr-vs-obsidian).

Q: Can I use the same folder for both?
A: Yes, but not recommended. Keep research notes (Obsidian) separate from paper drafts (Zettlr) for clarity.

Q: Do citation keys work the same way?
A: Yes. Both use Better BibTeX citation keys from Zotero. Configure once in the [Zotero guide](/docs/implementation/foundational-setup/zotero-setup-guide), then use the same keys everywhere.

Q: Is Zettlr required for Research Memex?
A: No, it's optional. But if you're writing papers (not just taking notes), Zettlr makes citations and export much easier than Obsidian.

Q: Can I write my entire dissertation in Zettlr?
A: Yes. Use Projects to organize chapters, then compile into a single PDF or Word document.

## Next steps [#next-steps]

1. Install Zettlr and connect to your Zotero library
2. Create a test document with 3-5 citations
3. Export to PDF or Word to verify setup
4. Start drafting your next paper section in Zettlr
5. Keep using Obsidian for research notes and synthesis

Research in Obsidian, draft in Zettlr, and export to journals; Better BibTeX keeps the citation keys consistent across both tools.