Online LaTeX equation editor, generate your mathematical expressions using LaTeX with a simple way. Functions ln log exp lg sin cos tan csc sec cot sinh cosh tanh coth arcsin arccos arctan arccsc arcsec arccot argsinh argcosh argtanh. Feature-rich editor with real-time collaboration, discussions in the margin, autocompletion, spellchecker, instant math previewer and other goodies. Template Gallery Create new documents instantly from one of our templates.
TikZiT is a super simple GUI editor for graphs and string diagrams. Its native file format is a subset of PGF/TikZ, which means TikZiT files can be included directly in papers typeset using LaTeX. Pre-built versions are available for systems running Windows, Linux, or macOS. Packages are available for some Linux distributions, or you can build from source.
- Quickstart
- Tips and Tricks
Windows: Click 'Windows (exe)' above to download a zip file and extract it to a convenient place (e.g. C:tikzit). If you wish to associate .tikz files with TikZiT, run the included .reg file (optional). Note you may need to edit the .reg file with a text editor if you place TikZiT in a different location. You can also install with Chocolatey via choco install tikzit.
Linux: If you do not wish to build from source, click 'Linux (portable binary)' above to download a tarball and extract it to a convient place (e.g. your home directory). Then, launch the application with ~/tikzit/bin/tikzit (assuming you extracted into your home directory). You may wish to add ~/tikzit/bin to your PATH and install the application launcher and file associations by running ./install-local.sh from inside the TikZiT directory.
There are also packages available for several Linux distributions, maintained by volunteers in the open source community. Here are the ones I know about:
- Ubuntu 19.10+, Debian testing/unstable:
apt install tikzit - arch linux:
pacman -S tikzit - NixOS:
nix-env -i tikzit - Fedora 32:
yum install tikzit
If you are a package maintainer for another distro, get in touch and I will add instructions here.
macOS: Click 'macOS (dmg)' above to download a dmg file. Open this file and copy tikzit.app to your Applications folder. Depending on your system settings, the first time you run TikZiT, you may need to right-click the .app file and select Open from the menu to get the option to run it. After this, you can run TikZiT like a normal application. You can also install with HomeBrew by running brew install tikzit in a terminal.
Note: The version of TikZiT above requires at least macOS version 10.11 (Yosemite). If you are running an older version of macOS (10.8-10.10), use this version instead. However, to get the latest version of TikZiT, it is recommended to update your operating system.
While TikZiT is easy to use, a few things might not be obvious the first time you run the program. This guide should get you going as quickly as possible. For mac users: throughout this tutorial, substitute ctrl = command and alt = option, as usual.
This tutorial will cover basic editing all the way up to building a LaTeX paper with TikZiT figures in it. Create a new, empty folder somewhere on your computer (which I will refer to as tikzpaper throughout this tutorial). Download tikzit.sty and place it in the folder. Also, create a new sub-directory called figures, which we will use later.
Basic node and edge editing
When you open TikZiT for the first time, you will see something that looks like this:
The window is divided into two parts: the main part is the graph editor and the part along the side is the style palette. For editing graphs, there are 3 tools: the select tool, the add node tool, and the add edge tool. These can be selected quickly by pressing s, n, or e while the graph editor is in focus.
Pick the node tool and click on the graph a few times to add some nodes. You will notice these appear in TikZiT as dashed circles with a small dot in the middle. These are called invisible nodes. These will not appear in the actual typeset output. However, they can be labelled with pieces of LaTeX code (see below), which will appear in your figure, or used to attach edges. To add edges, select the edge tool and click and drag from one node to another.
Pick the select tool again. You can select individual nodes or edges by clicking on them. You can select multiple nodes by dragging a box around the, and you can select multiple nodes or edges by clicking while holding down the ctrl key.
Selected nodes can be moved by dragging the mouse, or by pressing ctrl + arrow keys. Nodes are locked on a grid, so they normally only move in increments of 0.25 in TikZ coordinates. However, they can be 'nudged' by increments of 0.025 by pressing ctrl + shift + arrow keys. This is convenient e.g. for centering nodes between others (5 nudges = 1/2 normal grid cell).
Double-clicking a node gives the ability to set a label, which can contain LaTeX code:
Clicking on an edge reveals extra controls for bending the edge. There are two kinds of bend-modes in TikZiT, the basic bend mode (blue controls). Dragging either of the control points will cause the edge to bend to the left or the right:
Double-clicking the edge will change it to bezier bend mode (green controls). Now, each of the control points can be dragged independently:
Adding styles
Before we can create non-invisible nodes, we will need some styles. To set up styles, we will first create a new style file. In the style palette, click the button, go to the tikzpaper folder, and give the new style file a name, e.g. sample.tikzstyles. Now, we can edit the style file by clicking . This will open the style editor:
On the left side of the window, there is a list of node styles, followed by a list of edge styles. Currently, both lists contain only a single style, called 'none'. Click the '+' under the list of node styles to add a new node style, and call it red dot. Set the fill color to red, the draw color to black, and the shape to 'circle'. Then, click '+' again to add a new style called green dot. Set the fill color to green, the draw color to black, and again the shape to 'circle'.
Note: You can optionally set 'in TikZiT' versions of the 'draw', 'fill', and 'shape' properties. This will make nodes or edges look different in TikZiT, but have no effect on how they are typeset. This is useful for visually distinguishing similar styles.
Note: Arrowhead expressions containing a dash (e.g. -, ->, <-, |->, <->) play a special role in TikZiT. If you change them manually or use them as style names, you might get some strange behaviour. To customise the appearance of arrow heads/tails, try adding a property in the style editor called > or < and setting it to stealth, latex, etc. (see the PGF/TiKZ manual for possible arrowhead styles).
You may also wish to add some edge styles by clicking the '+' under the list of edge styles. If you have many styles, you can also organise them into categories by setting the 'Category' field. When you are done adding styles, click 'Save and Close' to return to the graph editor.
Next is the 'Properties' box. Here, you can add properties to the style which will affect the way a node or edge appears when you typeset it, but may not affect its appearance in the TikZiT GUI. Properties come in two flavours: normal properties, which have a name and a value (e.g. line width=1pt) and atoms, which only have a name (e.g. ultra thick). You can add a normal property by clicking '+' under the Properties box and an atom by clicking '+a'.
Any valid PGF/TikZ is fair game for properties, and there are tons of ways to customise the appearance of nodes and edges this way (e.g. making them thick or thin, have crazy shapes, gradients, dashes and dots, brackets, ...). The best way to find what you need is by looking in the PGF/TiKZ manual or finding examples on texample.net, the TeX StackExchange, etc.
Now, you will see your new styles in the style palette on the right. To apply a style to a node (or edge), select the node (or edge) it and double-click on the style. If you create new nodes and edges with a certain style selected, they will automatically get that style. To turn nodes these back into invisible nodes, select them and double-click on the 'none' style.
The above figure was created with 5 invisible nodes (2 inputs, 2 outputs, and 1 for the equals sign), 2 'red dot' nodes, and 2 'green dot' nodes.
Typesetting in LaTeX
We can now save the figure we created and include it directly in a paper. At the beginning of the tutorial, we created a new folder called tikzpaper containing nothing but tikzit.sty a sub-directory called figures. In TikZiT, click File > Save As..., navigate to tikzpaper/figures, and save or newly-created figure as fig1.tikz.
In a tex(t) editor, create a new file in the tikzpaper folder called paper.tex, and add the following tex:
tikzfig.sty provides two macros for including .tikz files: tikzfig and ctikzfig. They both take as an argument the name of a figure (without the .tikz extension), and will search for that figure either in the same directory or in a subdirectly called figures if it exists. Use tikzfig{FIG} to include FIG.tikz inline or as part of an equation. Use ctikzfig{FIG} to include FIG.tikz centered on its own line.
Note: Inline TikZ figures align the origin (0,0) to the center of the text line by default, so it's a good idea to always center TikZ pictures on the origin (as indicated by the slightly darker grid lines). This can be tweaked by setting the baseline or yshift properties of the TikZ figure, e.g. begin{tikzpicture}[yshift=-1mm] ....
Use pdflatex to build paper.tex, and you should get something that looks like this:
Previewing diagrams in TikZiT
Starting with TikZiT 2.1, it is possible to preview your figures directly in TikZiT by pressing ctrl + r.
If you get a green checkmark, the preview was generated successfully. Otherwise, you can click on the Output tab in the Preview window to see what went wrong.
Note: TikZiT will try to find pdflatex automatically by first searching your system path then common installation locations for TeX. If it fails, you can set the location of pdflatex manually in Tools > Preferences (Windows/Linux) or tikzit > Preferences (macOS).
Adding custom LaTeX code to previews
TikZiT automatically includes tikzit.sty and the active *.tikzstyles file when it generates its preview. So, in the example above, sample.tikzstyles is included automatically. TikZiT will also search the same directory for a *.tikzdefs file with the same name as the active TikZ style file and include it, if it exists. This file can be used to include extra packages, define macros, set up custom PGF/TikZ shapes, etc.
For example, if the active TikZ style file is called sample.tikzstyles, create a new file called sample.tikzdefs in the same directory as sample.tikzstyles with the following LaTeX source:
This file loads the LaTeX package bm and defines a new macro param, which can be used TikZ pictures. Back in TikZiT, double-click a node and set the label to, e.g. param{alpha}, and hit ctrl + r again. TikZiT will automaticall find sample.tikzdefs and include it when it makes the preview:
To make this macro available in your paper, as well as the preview, add input{sample.tikzdefs} to the preamble:
Latex Editor Led
Note: The use of *.tikzstyles and *.tikzdefs files in the preview replaces the 'Custom Preambles' feature from TikZiT 1.
Exporting images
After you generate a preview, you can export the image to a file or the clipboard by right-clicking on the preview itself and selecting the appropriate option.
If you select Export Image..., the Export Image dialog will be shown, where you can choose where to save the file, as well as its size and format. For the format, you can choose to save either PNG, JPG, or the original PDF file generated by pdflatex. To obtain SVG output, it is recommended that you export to PDF, then use a vector graphics utility such as Inkscape to convert to SVG.
There are quite a few tricks to getting things to look nice in TikZiT, usually using a combination of PGF/TikZ hackery and invisible nodes. Here are a quick tips:
- Right-clicking on blank space with the
Selecttool active will create a node. Right-clicking and dragging between nodes will create edges. - To get dashed edges, add the atom 'dashed' to an edge style. That is, select an edge style in the style editor, click '+a' under properties and change the text 'new atom' to 'dashed'.
- For very large or unusual shapes, sometimes it is easier to just draw the shape with invisible nodes and bezier edges.
- Hold down shift while moving the mouse wheel or two-finger scrolling to pan and hold down ctrl to zoom. If your mouse wheel only scrolls vertically, hold down alt + shift while moving the wheel to scroll horizontally.
- TikZiT style files can be edited in a text editor. The format is very simple: just a list of commands of the form
tikzstyle{NAME}=[PROPERTIES](see below). This is convenient for bulk editing or merging sets of styles. After you edit a style file, click in the style palette to refresh the styles. - You can mix math and TikZ figures on the same line, e.g.
[ tikzfig{fig-lhs} = tikzfig{fig-rhs} ]. This is useful if you have long strings of equalities or re-use figures many times. - To scale a whole TikZ figure up or down uniformly (including text), wrap the
tikzfigcommand in ascalebox. To just scale coordinates, use thescale,xscale, oryscaleTikZ properties.
The following sections give some more detailed tips.
Paths and filled shapes
Sometimes it is useful to treat a sequence of adjacent edges as one continuous path. For example, dashes and dots may look strange if they are applied to adjacent edges that are not part of a single path. Suppose we create an edge style called big dashes in the style editor with the following properties:
Then, we can make a complex shape using blank nodes and edges. Unfortunately the output doesn't look so good:
Yuck! The super-long dashes happen because TikZ doesn't know these edges are all part of one path. To fix this, select all of the edges by holding the CTRL key and clicking each of them, then go to Edit > Path > Make Path or hit CTRL+P. Now, you should notice two things. First, if you click on any of the edges, the whole path becomes selected. Second, the output looks a lot better:
Perhaps more importantly, you can use edge styles to create filled paths. To do this, go to an edge style in the style editor, uncheck none next to fill colour, and set the colour just like you would for a node:
The fill colour is shown in the bottom half of the edge style's icon in the style palette. If we save the style and preview again, this is the result:
Latex Editor online, free
If you want to split a path back into individual edges, go to Edit > Path > Split Path or hit CTRL+SHIFT+P. Note that if a fill colour is set, it may still appear under curved edges in the output, even though it doesn't show up in TikZiT.
Keyboard shortcuts for edge bending
If you select an edge and hold down the ctrl key, you will notice a <> symbol appear above one endpoint of the edge. If you use the left and right arrow keys, this adjust the in-angle of the edge. If you hold ctrl + shift, the other end of the edge will highlight and you can adjust the out-angle similarly. In either case, the up and down arrows adjust the looseness of the edge.
Editing TikZ source (e.g. node and edge properties)
With a node/edge selected, press ctrl + j to jump to that line of the TikZ source.
You can edit this by hand, and press ctrl + t to update the graph editor with the new TikZ code. You need to be a bit careful, since TikZiT only understands a subset of TikZ, but adding and removing TikZ properties on nodes or edges works just fine. For this, the PGF/TikZ manual is your friend.
If you can't get the TikZ code to parse again, or you decide you didn't want to make a change after all, you can revert your changes to the TikZ code by pressing ctrl + alt + t.
Adding labels next to nodes
Normally labels added by double-clicking a node will appear inside the node. However, you can add a label next to a node by selecting the node, pressing ctrl + j and adding a label property to the node in the TikZ source. Once you set a label this way, it will be shown above the node in TikZiT:
The label property is typically given in the form label={POSITION:TEXT}, where TEXT can be any LaTeX code, just like with normal labels. The label property in the example above is set to label={above:1}. This places the text 1 directly above the node. Possiblities for POSITION include above, below, left, right, and auto (see the PGF manual for details). Note the POSITION only affects where the label will be typeset. For simplicity, TikZiT always shows the label above the node.
Merging nodes
Press ctrl + m to merge selected nodes with any nodes that are at the same location. A particularly handy use-case is in making symmetric figures. For example, suppose we want to make a box with two, symmetric input wires. Make the first input wire, then select the box and the first input:
Then, make a copy of this part of the diagram using the clipboard, and vertically with alt + ▼:
Drag the duplicated part into place, and press ctrl + m:
...and we have one node with 2 inputs. Note that you might not visually see any change when you merge, but jumping to the TikZ source, we see there is indeed only one node in the middle.
Making boxes with multiple input/output wires
For string diagrams, flowcharts, etc. one often wants to create boxes with multiple input and output wires. While TikZ has a notion of 'anchors' which support this, I find the following technique more convenient.
TikZiT always draws nodes on top of edges, so to draw boxes with multiple inputs and outputs, first create one or more node styles for boxes. To get large boxes, click the '+' button under the property list and set the minimum width and minimum height properties. (Double-click a property or its value to change it.)
For example: a medium-sized box (2-3 inputs and outputs), drawn horizontally, looks pretty good with minimum width set to 0.75cm and minimum height set to 1cm.
Now, add nodes with the medium box style where you wish to put boxes. For example, here are two such boxes, labeled $f$ and $g$:
Then, create invisible nodes for inputs and outputs and draw edges to wire them together, getting a figure that looks like this:
The final typeset figure will then come out like this:
While it might seem a bit awkward to create styles for every possible size, in practice this isn't too bad, for 2 reasons:
- If you need a custom size as a one-off, you can use the ctrl + j trick from before to set the property on a single node.
- Having only a few sizes to choose from (e.g.
small box,medium box,large box) imposes some discipline on how you make your figures, and creates more consistent-looking papers overall. (This made a big difference here!)
Suppose later on we come to our senses and decide to draw figures from bottom-to-top rather than left-to-right. To do this, first swap the minimum height/width values in the style editor. That is, set minimum width to 1cm and minimum height to 0.75cm. Then, with our figure open, hit ctrl + a to select everything and alt + shift + ◂ to rotate counter-clockwise. Then we get this:
which typesets as:
Then, suppose even later on our annoying co-author insists figures go from top-to-bottom rather than bottom-to-top. To fix this, hit ctrl + a to select everything again and alt + ▼ to flip vertically. Then we get a new TikZ figure, which typesets as:
Using texopen.py to open TiKZ from PDFs
Many PDF readers have a reverse lookup feature, which enables you to jump to a line of Tex code when e.g. double-clicking a point in the generated PDF document. Normally, you want the line of TeX to be displayed in your main text editor or LaTeX editor, but if you click on a part of the PDF which came from a tikzfig, it is convenient for this to open directly in TikZiT.
This can be done via the following python script, texopen.py:
Note this script uses Sublime Text as the default editor (hence subl in the last line above). Obviously you can customise this to use your preferred editor.
To use this script, place it somewhere that your PDF viewer can find, and set it up as your 'editor'. For example, in Okular, go to Settings > Configure Okular.... Click on the Editor tab, select 'Custom Text Editor' and add the following as the command: texopen.py %f %l. Here, the %f is a placeholder for the active file, and %l the line of code.
Configuration in other popular PDF editors (e.g. Preview, Skim, Sumatra) should be similar. On Windows systems, you will probably want to set the editor as something like C:pathtopython.exe C:pathtotexopen.py %f %l.
For reverse lookups to work, make sure you are building with synctex enabled. This happens automatically if you are using a tool like Latexmk or various GUI LaTeX editors or plugins. You will typically see a file with an extension like *.synctex.gz being generated when you build.
TikZiT's .tikz and .tikzstyle file formats are both subsets of PGF/TikZ's TeX-based format. TikZ style files have a very simple format. They are just a list of tikzstyle commands. Here is the full grammar:
Where SIMPLE_STRING means a string consisting of letters, numbers, and whitespace and DELIMITED_STRING means a string inside of curly braces. The latter can contain nested curly braces, provided they occur in matched pairs.
TikZ figure files consist of a {tikzpicture} environment, in which there is a list of node commands, followed by a list of edge commands. Nodes and edges, as well as the figure as a whole can have properties. Here is the full grammar:
Note: TikZiT 2.x currently does not use the bounding box command, but it is allowed for compatibility with TikZiT 1 files.
Copyright © 2019. TikZiT project.
LaTeX is free software under the terms of the LaTeX Project Public License (LPPL). LaTeX is distributed through CTAN servers or comes as part of many easily installable and usable TeX distributions provided by the TeX User Group (TUG) or third parties. If you run into trouble, visit the help section.
LaTeX is not a stand-alone typesetting program in itself, but document preparation software that runs on top of Donald E. Knuth's TeX typesetting system. TeX distributions usually bundle together all the parts needed for a working TeX system and they generally add to this both configuration and maintenance utilities. Nowadays LaTeX, and many of the packages built on it, form an important component of any major TeX distribution.
- The LaTeX Git Repository
The LaTeX team cannot guarantee that TeX distributions, even recent ones, contain the most recent version of LaTeX. It may happen that you need a more recent LaTeX than the one that your favourite TeX distribution carries, e.g., in order to get a particular bug fix. In that case you will need to fetch LaTeX from CTAN and install it on top of your distribution. See below for details.
TeX Distributions
If you’re new to TeX and LaTeX or just want an easy installation, geta full TeX distribution. The TeX Users Group (TUG) has a list of notable distributionsthat are entirely, or least primarily, free software.
Linux
Check your Linux distributions software source for a TeX distribution including LaTeX. You can also install the current TeX Live distribution directly---in fact this may be advisable as many Linux distributions only contain older versions of TeX Live, see Linux TeX Live package status for details.
Mac OS
The MacTeX distribution contains everything you need, including a complete TeX system with LaTeX itself and editors to write documents.
Windows
Check out the MiKTeX or proTeXt or TeX Live distributions; they contain a complete TeX system with LaTeX itself and editors to write documents.
Online
LaTeX online services like Papeeria, Overleaf, ShareLaTeX, Datazar, and LaTeX base offer the ability to edit, view and download LaTeX files and resulting PDFs.
CTAN
You can obtain LaTeX from CTAN, which is theprimary source of distribution for LaTeX. In order for your downloadedLaTeX to be of any use, you have to obtain and set up a TeX systemfirst. You can either install a TeX distribution (see above) or get aTeX system from CTAN. Ifyou use a TeX distribution then it will include a version of LaTeX sothis will probably make things easier for you; but you may have areason not to do this.
The LaTeX Git Repository
These days the LaTeX development sources are kept in a GitHubrepository (previously we used SVN).
Anyone can access it and download the files, butsubmission is restricted to team members. The repository is located at https://github.com/latex3/latex2eand from that browser page you may explore the files, clone therepository or download the files in a .zip archive (roughly 25Mb) byusing the appropriate buttons.
If you are familiar with Git you can also clone the repository using thecommand line or your favorite Git fontend tool, e.g.,
which needs about 50Mb of space.Alternatively, you can do a Subversion checkout from the command line, e.g.,
which will just checkout the current files.But be aware that a SVN checkout of the form
will download all files including theirhistory (back to 2009) and amounts to roughly 1.4Gb so that is quite large.
Note: If you had bookmarked the old SVN repository please update thatbookmark to the new GIT repository as we have finally removed it.
A note on Git pull requests
Git repositories support distributed development and allow people toprovide change sets that are made available through so called pullrequests, so that the maintainers of a program can “pull the suggestedchanges” into the main repository.
While we appreciate contributions, we think that for the core LaTeXsoftware pull requests are usually not a good approach (unless thechange has be already discussed and agreed upon).The stability of LaTeX is very important and this means that changes tothe kernel are necessarily very conservative. It also means that a lotof discussion has to happen before any changes are made. So if you dodecide to post a pull request, please bear this in mind: we doappreciate ideas, but cannot always integrate them into the kernel andit is quite likely that we reject updates made in this way.
If you want to discuss a possible contribution before (or instead of)making a pull request, we suggest you raise the topic first onthe LATEX-L list or drop aline to the team.
Historic LaTeX
Ulrik Vieth has collected historic versions of LaTeX from LaTeX 2.0for TeX 1.0 (released on 11 December 1983) onwards. You can find thematftp://ftp.tug.org/historic/macros/latex-saildart/.There might even be some earlier versions. All files have been pulledfrom the SAILDART archive site at http://z.baumgart.org/ (no longeronline) which was based on archive tapes from SAIL at Stanford.
More historic material can be found at ftp://ftp.tug.org/historic (you may not be able to open this in all browsers — alternatively try https://www.math.utah.edu/pub/tex/historic/).