Written and maintained by CASRAI Editorial Board
Last updated
TeXstudio is a free, open-source editor for writing LaTeX documents. It is an editor, not a TeX engine: it needs a TeX distribution such as MiKTeX or TeX Live installed to turn your source into a PDF. This guide is for researchers who want to install it, run a first compile, read the error panel and decide whether it is the right tool compared with Overleaf, Texmaker, TeXworks or VS Code.
What TeXstudio is used for in research
The TeXstudio documentation describes it as an integrated writing environment for creating LaTeX documents. It runs on Windows, Linux, BSD and macOS (source: texstudio.org, checked 2026-11-07), and its GitHub repository lists the GNU General Public License v3.0. In research work it is used to write manuscripts, theses and reports in LaTeX on your own machine, with files stored locally rather than in a hosted project.
Features listed by the project include syntax highlighting, auto-completion, multiple cursors, more than 1000 math symbols, assistants for images, tables and formulas, a structure view, code folding, spell, grammar and reference checkers, an integrated PDF viewer with synchronisation between source and PDF, and live inline previews.
Install or access
Download TeXstudio only from the project site, texstudio.org, whose page links to the source on GitHub. The site offered version 4.9.9 when checked on 2026-11-07; check the download page for the current release.
Install a TeX distribution first
TeXstudio calls external programs to compile. The project states that it automatically detects MiKTeX, TeX Live and Ghostscript, so install one of the two distributions before your first compile. The editor will open without one, but compiling will fail because no LaTeX compiler can be found.
Windows
The site offers installers and portable zip files for x86-64 and Arm64 (Qt6 builds). It notes that Windows 11 needs the Visual Studio runtime. A portable version is available for running from a USB drive.
macOS
Zip builds are provided for Intel and for M1 Macs. The project notes that the app is not signed with an Apple Developer account, so on first launch Ctrl+click the app and choose Open. The site states the minimum macOS version in more than one place; check the download page for the figure that applies to your release.
Linux and BSD
The project recommends installing from your distribution’s repository first, with a PPA for Ubuntu and an AppImage as other routes. Source code is on GitHub.
Step by step: your first compile
- Install MiKTeX or TeX Live, then install and start TeXstudio.
- Create a new file and save it with a .tex extension. Save before compiling so the build files have a folder to be written to.
- Type a minimal document, for example a
\documentclass{article}line, a\begin{document}block with a sentence of text, and\end{document}. - Press F5 (Build & View). The documentation says it builds the document and then directly calls the View command, so the PDF opens in the integrated viewer.
- To build without opening the viewer, press F6 (Compile).
- If the document uses a bibliography, TeXstudio runs the compiler and, where needed, BibTeX several times until the final PDF is produced; you do not run each pass by hand. To use a different default compiler, change it in the Configure TeXstudio dialog.
Single tools can also be launched one at a time from the Tools menu. Source: Compiling a document, TeXstudio documentation, checked 2026-11-07.
Output and how to read it
The compiled PDF appears in the internal PDF viewer. Messages from the compiler appear in the log area, which has two views, selectable with the Log File and Issues buttons:
- Issues lists errors, warnings and bad boxes (overfull or underfull lines) in a table, so you can go straight to the offending line.
- Log File shows the raw compiler log, useful when the Issues table does not explain a failure.
The menu entries Show Error, Show Warning, Show BadBox and Show Log Markers control which problems are marked in the editor. Fix the first error before anything else: later messages often result from it.
Troubleshooting
The compile fails straight away
Confirm that MiKTeX or TeX Live is installed and that TeXstudio found it; without a distribution there is no compiler to call. Then read the Issues table for the first error.
Errors persist after you fixed the source
Stale auxiliary files can keep old errors alive. The Tools menu has a Clean command that removes files such as dvi, toc and aux while keeping your PDFs; run it and compile again.
Citations show as undefined
This is a bibliography pass problem rather than an editor fault. See fixing undefined citations in BibTeX and, for the choice between styles, LaTeX bibliography styles explained.
macOS refuses to open the app
Use Ctrl+click and choose Open, as described in the install section, because the app is not signed with an Apple Developer account.
Free alternatives to TeXstudio
Facts below come from each project’s own page, checked 2026-11-07. Prices and plan limits are not compared.
| Tool | Where it runs | What its own page says |
|---|---|---|
| TeXstudio | Windows, Linux, BSD, macOS (local) | Integrated writing environment for LaTeX; integrated PDF viewer with source/PDF sync; detects MiKTeX and TeX Live. |
| Texmaker | Windows, macOS, Linux (local) | Free cross-platform LaTeX editor since 2003; GPL license; unicode, spell checking, auto-completion, code folding, built-in PDF viewer with synctex. |
| TeXworks | Windows, macOS, Linux (local) | Presented as lowering the entry barrier to the TeX world; version 0.6.11 released February 2026. |
| LaTeX Workshop for VS Code | Inside Visual Studio Code (local) | An extension that provides core features for LaTeX typesetting in VS Code; MIT license (per its GitHub repository). |
| Overleaf | Web browser (hosted) | An online LaTeX editor; no local TeX installation to maintain. |
TeXstudio vs Texmaker
Both are free, cross-platform desktop editors with integrated PDF viewers. The difference is the feature set each project lists, so compare the two feature pages against your needs rather than assuming one is a superset of the other.
Local editor or online editor?
A local editor keeps files on your machine and works without a connection once a TeX distribution is installed. A hosted editor removes installation and is built around sharing a project with co-authors. For collaboration, see collaborative writing in LaTeX with Overleaf, Google Docs vs Overleaf vs Word for manuscripts and, for tablets, LaTeX on iPad. If you manage references in a LaTeX workflow, see Zotero vs JabRef for LaTeX-based writing.
Frequently asked questions
Is TeXstudio free?
Yes. The project distributes it as free, open-source software; its GitHub repository lists the GNU General Public License v3.0 (checked 2026-11-07).
Does TeXstudio include LaTeX?
No. It is an editor that calls a TeX distribution; install MiKTeX or TeX Live separately. It detects both.
Which systems does TeXstudio run on?
Windows, Linux, BSD and macOS, per the project site. There are Arm64 Windows builds and Intel and M1 macOS builds.
What do F5 and F6 do?
F6 compiles the document. F5 is Build & View: it builds and then calls the View command (TeXstudio documentation, Compiling a document).
Is there an online TeXstudio?
The project describes a desktop application. If you need a browser-based LaTeX editor, Overleaf is an online option; see the alternatives table above.
Where are TeXstudio templates and tutorials?
The official documentation at texstudio-org.github.io covers compiling, the internal PDF viewer, bibliographies, configuration and structuring documents. The editor also provides assistants for images, tables and formulas.
Sources
- TeXstudio project site and TeXstudio on GitHub, checked 2026-11-07.
- TeXstudio documentation and Compiling a document, checked 2026-11-07.
- Texmaker, TeXworks, LaTeX Workshop and Overleaf, checked 2026-11-07.
