<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="X-UA-Compatible" content="IE=Edge" />

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />

<title>Text &#8212; Matplotlib 3.5.3 documentation</title>

<!-- Loaded before other Sphinx assets -->

<link href="../../_static/styles/theme.css?digest=1999514e3f237ded88cf" rel="stylesheet">

<link href="../../_static/styles/pydata-sphinx-theme.css?digest=1999514e3f237ded88cf" rel="stylesheet">

<link rel="stylesheet"

href="../../_static/vendor/fontawesome/5.13.0/css/all.min.css">

<link rel="preload" as="font" type="font/woff2" crossorigin

href="../../_static/vendor/fontawesome/5.13.0/webfonts/fa-solid-900.woff2">

<link rel="preload" as="font" type="font/woff2" crossorigin

href="../../_static/vendor/fontawesome/5.13.0/webfonts/fa-brands-400.woff2">

<link rel="stylesheet" type="text/css" href="../../_static/pygments.css" />

<link rel="stylesheet" type="text/css" href="../../_static/css/style.css" />

<link rel="stylesheet" type="text/css" href="../../_static/graphviz.css" />

<link rel="stylesheet" type="text/css" href="../../_static/plot_directive.css" />

<link rel="stylesheet" type="text/css" href="../../_static/copybutton.css" />

<link rel="stylesheet" type="text/css" href="../../_static/sg_gallery.css" />

<link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-binder.css" />

<link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-dataframe.css" />

<link rel="stylesheet" type="text/css" href="../../_static/sg_gallery-rendered-html.css" />

<link rel="stylesheet" type="text/css" href="../../_static/panels-main.c949a650a448cc0ae9fd3441c0e17fb0.css" />

<link rel="stylesheet" type="text/css" href="../../_static/panels-variables.06eb56fa6e07937060861dad626602ad.css" />

<link rel="stylesheet" type="text/css" href="../../_static/mpl.css?v3.5.3-2-gade8736b7a" />

<!-- Pre-loaded scripts that we'll load fully later -->

<link rel="preload" as="script" href="../../_static/scripts/pydata-sphinx-theme.js?digest=1999514e3f237ded88cf">

<script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>

<script src="../../_static/jquery.js"></script>

<script src="../../_static/underscore.js"></script>

<script src="../../_static/doctools.js"></script>

<script src="../../_static/clipboard.min.js"></script>

<script src="../../_static/copybutton.js"></script>

<link rel="canonical" href="https://matplotlib.org/stable/tutorials/text/index.html" />

<link rel="search" type="application/opensearchdescription+xml"

title="Search within Matplotlib 3.5.3 documentation"

href="../../_static/opensearch.xml"/>

<link rel="shortcut icon" href="../../_static/favicon.ico"/>

<link rel="search" title="Search" href="../../search.html" />

<link rel="next" title="Text in Matplotlib Plots" href="text_intro.html" />

<link rel="prev" title="Complex and semantic figure composition" href="../provisional/mosaic.html" />

<meta name="viewport" content="width=device-width, initial-scale=1" />

<meta name="docsearch:language" content="None">

<script data-domain="matplotlib.org" defer="defer" src="https://views.scientific-python.org/js/script.js"></script>

</head>

<body data-spy="scroll" data-target="#bd-toc-nav" data-offset="60">

<div class="container-fluid" id="banner"></div>

<nav class="navbar navbar-light navbar-expand-lg bg-light fixed-top bd-navbar" id="navbar-main"><div class="container-xl">

<div id="navbar-start">

<a class="navbar-brand" href="../../index.html">

<img src="../../_static/logo2.svg" class="logo" alt="logo">

</a>

</div>

<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbar-collapsible" aria-controls="navbar-collapsible" aria-expanded="false" aria-label="Toggle navigation">

<span class="navbar-toggler-icon"></span>

</button>

<div id="navbar-collapsible" class="col-lg-9 collapse navbar-collapse">

<div id="navbar-center" class="mr-auto">

<div class="navbar-center-item">

<ul id="navbar-main-elements" class="navbar-nav">

<li class="nav-item">

<a class="reference internal nav-link" href="../../plot_types/index.html">Plot types</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../gallery/index.html">Examples</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../index.html">Tutorials</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../api/index.html">Reference</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../users/index.html">User guide</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../devel/index.html">Develop</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../../users/release_notes.html">Release notes</a>

</li>

</div>

</div>

<div id="navbar-end">

<div class="navbar-end-item">

<ul id="navbar-icon-links" class="navbar-nav" aria-label="Icon Links">

<li class="nav-item">

<a class="nav-link" href="https://gitter.im/matplotlib/matplotlib" rel="noopener" target="_blank" title="gitter">

<span><i class="fab fa-gitter"></i></span>

<label class="sr-only">gitter</label>

</a>

</li>

<li class="nav-item">

<a class="nav-link" href="https://discourse.matplotlib.org" rel="noopener" target="_blank" title="discourse">

<span><i class="fab fa-discourse"></i></span>

<label class="sr-only">discourse</label>

</a>

</li>

<li class="nav-item">

<a class="nav-link" href="https://github.com/matplotlib/matplotlib" rel="noopener" target="_blank" title="GitHub">

<span><i class="fab fa-github-square"></i></span>

<label class="sr-only">GitHub</label>

</a>

</li>

<li class="nav-item">

<a class="nav-link" href="https://twitter.com/matplotlib/" rel="noopener" target="_blank" title="twitter">

<span><i class="fab fa-twitter-square"></i></span>

<label class="sr-only">twitter</label>

</a>

</li>

</ul>

</div>

</div>

</div>

</nav>

<div class="container-xl">

<div class="row">

<!-- Only show if we have sidebars configured, else just a small margin -->

<div class="col-12 col-md-3 bd-sidebar">

<div class="sidebar-start-items"><form class="bd-search d-flex align-items-center" action="../../search.html" method="get">

<i class="icon fas fa-search"></i>

<input type="search" class="form-control" name="q" id="search-input" placeholder="Search the docs ..." aria-label="Search the docs ..." autocomplete="off" >

</form><nav class="bd-links" id="bd-docs-nav" aria-label="Main navigation">

<div class="bd-toc-item active">

<ul class="current nav bd-sidenav">

<li class="toctree-l1 has-children">

<a class="reference internal" href="../introductory/index.html">

Introductory

</a>

<input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" type="checkbox"/>

<label for="toctree-checkbox-1">

<i class="fas fa-chevron-down">

</i>

</label>

<ul>

<li class="toctree-l2">

<a class="reference internal" href="../introductory/usage.html">

Basic Usage

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../introductory/pyplot.html">

Pyplot tutorial

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../introductory/images.html">

Image tutorial

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../introductory/lifecycle.html">

The Lifecycle of a Plot

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../introductory/customizing.html">

Customizing Matplotlib with style sheets and rcParams

</a>

</li>

</ul>

</li>

<li class="toctree-l1 has-children">

<a class="reference internal" href="../intermediate/index.html">

Intermediate

</a>

<input class="toctree-checkbox" id="toctree-checkbox-2" name="toctree-checkbox-2" type="checkbox"/>

<label for="toctree-checkbox-2">

<i class="fas fa-chevron-down">

</i>

</label>

<ul>

<li class="toctree-l2">

<a class="reference internal" href="../intermediate/artists.html">

Artist tutorial

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../intermediate/legend_guide.html">

Legend guide

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../intermediate/color_cycle.html">

Styling with cycler

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../intermediate/constrainedlayout_guide.html">

Constrained Layout Guide

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../intermediate/tight_layout_guide.html">

Tight Layout guide

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../intermediate/arranging_axes.html">

Arranging multiple Axes in a Figure

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../intermediate/autoscale.html">

Autoscaling

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../intermediate/imshow_extent.html">

<em>

origin

</em>

and

<em>

extent

</em>

in

<code class="xref py py-obj docutils literal notranslate">

<span class="pre">

imshow

</span>

</code>

</a>

</li>

</ul>

</li>

<li class="toctree-l1 has-children">

<a class="reference internal" href="../advanced/index.html">

Advanced

</a>

<input class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" type="checkbox"/>

<label for="toctree-checkbox-3">

<i class="fas fa-chevron-down">

</i>

</label>

<ul>

<li class="toctree-l2">

<a class="reference internal" href="../advanced/blitting.html">

Faster rendering by using blitting

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../advanced/path_tutorial.html">

Path Tutorial

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../advanced/patheffects_guide.html">

Path effects guide

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../advanced/transforms_tutorial.html">

Transformations Tutorial

</a>

</li>

</ul>

</li>

<li class="toctree-l1 has-children">

<a class="reference internal" href="../colors/index.html">

Colors

</a>

<input class="toctree-checkbox" id="toctree-checkbox-4" name="toctree-checkbox-4" type="checkbox"/>

<label for="toctree-checkbox-4">

<i class="fas fa-chevron-down">

</i>

</label>

<ul>

<li class="toctree-l2">

<a class="reference internal" href="../colors/colors.html">

Specifying Colors

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../colors/colorbar_only.html">

Customized Colorbars Tutorial

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../colors/colormap-manipulation.html">

Creating Colormaps in Matplotlib

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../colors/colormapnorms.html">

Colormap Normalization

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../colors/colormaps.html">

Choosing Colormaps in Matplotlib

</a>

</li>

</ul>

</li>

<li class="toctree-l1 has-children">

<a class="reference internal" href="../provisional/index.html">

Provisional

</a>

<input class="toctree-checkbox" id="toctree-checkbox-5" name="toctree-checkbox-5" type="checkbox"/>

<label for="toctree-checkbox-5">

<i class="fas fa-chevron-down">

</i>

</label>

<ul>

<li class="toctree-l2">

<a class="reference internal" href="../provisional/mosaic.html">

Complex and semantic figure composition

</a>

</li>

</ul>

</li>

<li class="toctree-l1 current active has-children">

<a class="current reference internal" href="#">

Text

</a>

<input checked="" class="toctree-checkbox" id="toctree-checkbox-6" name="toctree-checkbox-6" type="checkbox"/>

<label for="toctree-checkbox-6">

<i class="fas fa-chevron-down">

</i>

</label>

<ul>

<li class="toctree-l2">

<a class="reference internal" href="text_intro.html">

Text in Matplotlib Plots

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="text_props.html">

Text properties and layout

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="annotations.html">

Annotations

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="mathtext.html">

Writing mathematical expressions

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="pgf.html">

Typesetting with XeLaTeX/LuaLaTeX via the

<code class="docutils literal notranslate">

<span class="pre">

pgf

</span>

</code>

backend

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="usetex.html">

Text rendering with LaTeX

</a>

</li>

</ul>

</li>

<li class="toctree-l1 has-children">

<a class="reference internal" href="../toolkits/index.html">

Toolkits

</a>

<input class="toctree-checkbox" id="toctree-checkbox-7" name="toctree-checkbox-7" type="checkbox"/>

<label for="toctree-checkbox-7">

<i class="fas fa-chevron-down">

</i>

</label>

<ul>

<li class="toctree-l2">

<a class="reference internal" href="../toolkits/axes_grid.html">

Overview of

<code class="xref py py-mod docutils literal notranslate">

<span class="pre">

mpl_toolkits.axes_grid1

</span>

</code>

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../toolkits/axisartist.html">

Overview of axisartist toolkit

</a>

</li>

<li class="toctree-l2">

<a class="reference internal" href="../toolkits/mplot3d.html">

The mplot3d Toolkit

</a>

</li>

</ul>

</li>

</div>

</div>

<div class="sidebar-end-items">

</div>

</div>

<div class="d-none d-xl-block col-xl-2 bd-toc">

<div class="toc-item">

<nav id="bd-toc-nav">

</div>

<div class="toc-item">

</div>

</div>

<main class="col-12 col-md-9 col-xl-7 py-md-5 pl-md-5 pr-md-4 bd-content" role="main">

<div>

<section id="text">

<span id="tutorials-text"></span><span id="sphx-glr-tutorials-text"></span><h1>Text<a class="headerlink" href="#text" title="Permalink to this headline">#</a></h1>

<p>matplotlib has extensive text support, including support for

mathematical expressions, truetype support for raster and

vector outputs, newline separated text with arbitrary

rotations, and unicode support. These tutorials cover

the basics of working with text in Matplotlib.</p>

<div class="sphx-glr-thumbnails"><div class="sphx-glr-thumbcontainer" tooltip="Introduction to plotting and working with text in Matplotlib."><img alt="Text in Matplotlib Plots" src="../../_images/sphx_glr_text_intro_thumb.png" />

<p><a class="reference internal" href="text_intro.html#sphx-glr-tutorials-text-text-intro-py"><span class="std std-ref">Text in Matplotlib Plots</span></a></p>

<div class="sphx-glr-thumbnail-title">Text in Matplotlib Plots</div>

</div><div class="sphx-glr-thumbcontainer" tooltip="Controlling properties of text and its layout with Matplotlib."><img alt="Text properties and layout" src="../../_images/sphx_glr_text_props_thumb.png" />

<p><a class="reference internal" href="text_props.html#sphx-glr-tutorials-text-text-props-py"><span class="std std-ref">Text properties and layout</span></a></p>

<div class="sphx-glr-thumbnail-title">Text properties and layout</div>

</div><div class="sphx-glr-thumbcontainer" tooltip="Annotating text with Matplotlib."><img alt="Annotations" src="../../_images/sphx_glr_annotations_thumb.png" />

<p><a class="reference internal" href="annotations.html#sphx-glr-tutorials-text-annotations-py"><span class="std std-ref">Annotations</span></a></p>

<div class="sphx-glr-thumbnail-title">Annotations</div>

</div><div class="sphx-glr-thumbcontainer" tooltip="You can use a subset of TeX markup in any Matplotlib text string by placing it inside a pair of..."><img alt="Writing mathematical expressions" src="../../_images/sphx_glr_mathtext_thumb.png" />

<p><a class="reference internal" href="mathtext.html#sphx-glr-tutorials-text-mathtext-py"><span class="std std-ref">Writing mathematical expressions</span></a></p>

<div class="sphx-glr-thumbnail-title">Writing mathematical expressions</div>

</div><div class="sphx-glr-thumbcontainer" tooltip="Using the pgf backend, Matplotlib can export figures as pgf drawing commands that can be proces..."><img alt="Typesetting with XeLaTeX/LuaLaTeX via the ``pgf`` backend" src="../../_images/sphx_glr_pgf_thumb.png" />

<p><a class="reference internal" href="pgf.html#sphx-glr-tutorials-text-pgf-py"><span class="std std-ref">Typesetting with XeLaTeX/LuaLaTeX via the pgf backend</span></a></p>

<div class="sphx-glr-thumbnail-title">Typesetting with XeLaTeX/LuaLaTeX via the ``pgf`` backend</div>

</div><div class="sphx-glr-thumbcontainer" tooltip="Matplotlib can use LaTeX to render text. This is activated by setting text.usetex : True in yo..."><img alt="Text rendering with LaTeX" src="../../_images/sphx_glr_usetex_thumb.png" />

<p><a class="reference internal" href="usetex.html#sphx-glr-tutorials-text-usetex-py"><span class="std std-ref">Text rendering with LaTeX</span></a></p>

<div class="sphx-glr-thumbnail-title">Text rendering with LaTeX</div>

</div></div><div class="toctree-wrapper compound">

</div>

</main>

</div>

</div>

<!-- Scripts loaded after <body> so the DOM is not blocked -->

<div id="unreleased-message"> You are reading an old version of the documentation (v3.5.3). For the latest version see <a href="https://matplotlib.org/stable/tutorials/text/index.html">https://matplotlib.org/stable/tutorials/text/index.html</a></div>

<script src="../../_static/scripts/pydata-sphinx-theme.js?digest=1999514e3f237ded88cf"></script>

<footer class="footer mt-5 mt-md-0">

<div class="container">

<div class="footer-item">

<p class="copyright">

&copy; Copyright 2002 - 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the Matplotlib development team; 2012 - 2022 The Matplotlib development team.<br>

</div>

<div class="footer-item">

<p class="sphinx-version">

Created using <a href="http://sphinx-doc.org/">Sphinx</a> 4.5.0.<br>

</div>

</div>

</body>