MG75 MathGuide
MG75 MathGuide
This document is Copyright © 2023 by the LibreOffice Documentation Team. Contributors are
listed below. You may distribute it and/or modify it under the terms of either the GNU General
Public License (https://www.gnu.org/licenses/gpl.html), version 3 or later, or the Creative
Commons Attribution License (https://creativecommons.org/licenses/by/4.0/), version 4.0 or later.
All trademarks within this guide belong to their legitimate owners.
Contributors
To this edition
Vítor Ferreira Olivier Hallot
To previous editions
Rafael Lima Olivier Hallot Jean Hollis Weber
Roman Kuznetsov Dave Barton Regina Henschel
Peter Schofield Hazel Russman Laurent Balland-Poirier
Jean Hollis Weber Daniel Carrera Agnes Belzunce
T. J. Frazier Peter Kupfer Ian Laurenson
Janet M. Swisher Michele Zarri Florian Reisinger
Christian Kühl Jochen Schiffers Frédéric Parrenin
Gisbert Friege (Dmaths) Bernard Siaud
LibreOffice 7.x Guide Series cover design by Rizal Mutaqin.
Feedback
Please direct any comments or suggestions about this document to the Documentation Team’s
forum at https://community.documentfoundation.org/c/documentation/loguides/ (registration is
required) or send an email to: [email protected].
Note
Everything you send to a mailing list, including your email address and any other
personal information that is written in the message, is publicly archived and cannot
be deleted.
Preface
Who is this book for?
LibreOffice Math is a formula (equation) editor that is an integral part of LibreOffice. Anyone who
wants to learn how to insert formulas and equations using Math will find this guide valuable.
In LibreOffice, formulas can be inserted as objects into Writer, Impress, Draw, and Calc
documents. Regardless of the document type, formula objects are edited using LibreOffice Math.
If you want an introduction to all of the LibreOffice components, you might like to read the Getting
Started Guide first.
Note
LibreOffice Math is not capable of evaluating mathematical equations or performing
calculations. For that purpose, you should use LibreOffice Calc; see the Calc Guide.
Help system
LibreOffice comes with an extensive online Help system. This is your first line of support.
Windows and Linux users can choose to download and install the Help for use when not
connected to the Internet; the offline Help is installed with the program on macOS.
To display the Help system, press F1 or go to Help > LibreOffice Help on the Menu bar. If you
do not have the offline help installed on your computer and you are connected to the Internet,
your default browser will open the online Help pages on the LibreOffice website.
The Help menu also includes links to other LibreOffice information and support facilities. The
options marked by a ‡ sign in the list below are only accessible if your computer is connected to
the Internet.
• What's This? For quick tips when a toolbar is visible, place the mouse pointer over any of
the icons to see a small box (“tooltip”) with a brief explanation of the icon’s function. For a
more detailed explanation, select Help > What's This? and hold the pointer over the
icon. In addition, you can choose whether to activate Extended Tips using Tools >
Options > LibreOffice > General.
• User Guides ‡ Opens your default browser at the Documentation page of the LibreOffice
website, https://documentation.libreoffice.org/en/english-documentation/. There you will
find copies of user guides and other useful information.
• Show Tip of the Day Opens a small window with a random tip on how to use LibreOffice.
• Search Commands In Writer, Calc, Impress, and Draw (but not Base or Math), opens a
window where you can type a few letters or the name of a Menu bar command, to quickly
find where the command is located. Clicking on a command in the resulting list may open
a relevant dialog or have other effects.
• Get Help Online ‡ Opens your default browser at the Ask LibreOffice forum of questions
and answers from the LibreOffice community, https://ask.libreoffice.org/en/questions/.
• Send Feedback ‡ Opens your default browser at the Feedback page of the LibreOffice
website, https://www.libreoffice.org/get-help/feedback/. From there you can report bugs,
suggest new features and communicate with others in the LibreOffice community.
Preface | 7
Paid support and training
You can also pay for support through service contracts from a vendor or consulting firm
specializing in LibreOffice. For information about certified professional support, see The
Document Foundation’s website: https://www.documentfoundation.org/gethelp/support/.
For schools, educational and research institutions, and large organizations, see
https://www.libreoffice.org/download/libreoffice-in-business/.
Illustrations
The illustrations in this guide were taken from the Windows 10 operating system. Therefore,
some illustrations will not look exactly like what you see on your computer display.
Also, some of the dialogs may be different because of the settings selected in LibreOffice. In
some cases (mainly Open, Save, and Print dialogs), you can choose to use dialogs from your
computer’s operating system or dialogs provided by LibreOffice. To change which dialogs are
used, go to Tools > Options > LibreOffice > General (on Windows and Linux) or LibreOffice >
Preferences > General (on macOS) and select or deselect the option Use LibreOffice dialogs.
Icons
The LibreOffice community has created icons for several icon sets: Breeze, Colibre, Elementary,
Karasa Jaga, Sifr, and Sakapura; some are also available in a dark version. As a user, you can
select your own preferred set. The icons in this guide have been taken from a LibreOffice
installation that has been set to display the default set of icons. The icons you see for some of
the many tools available in LibreOffice may differ from the ones used in this guide.
To change the icon set used, go to Tools > Options > LibreOffice > View. In the Icon style
section, choose from the drop-down list.
Notes
Some Linux distributions include LibreOffice as part of the installation and may not
include all the icon sets mentioned above. You should be able to download other
icon sets from the software repository for your Linux distribution if you wish to use
them.
The Galaxy, Oxygen, and Tango icon sets are no longer included as part of the
standard installation package. You can download and install them as extensions from
https://extensions.libreoffice.org/en/extensions/.
Preface | 9
Math Guide 7.3
Chapter 1,
Creating and Editing Formulas
Introduction
Math is a formula editor included with LibreOffice that you can use to create or edit formulas
(equations) in a symbolic form, within LibreOffice documents or as stand-alone objects. Example
formulas are shown below:
df (x)
=ln (x)+tan −1 (x 2) or NH3 +H2 O ⇌ NH+4 +OH −
dx
The Formula Editor in Math uses a markup language to represent formulas. This markup
language is designed to be easily read wherever possible. For example, a over b using
a
markup language produces the fraction when used in a formula.
b
Getting started
Using the Formula Editor, you can create a formula as a separate file for a formula library or
insert formulas directly into a document using LibreOffice Writer, Calc, Impress, or Draw.
If you frequently insert formulas into documents, it is recommended to add the Formula button to
the Standard toolbar or create a keyboard shortcut. See “Adding keyboard shortcuts” on page 47
for more information.
Creating formulas
You can create a formula using one of the following methods:
• In the Elements panel, select a category from the drop-down list, then a symbol.
• Right-click in the Formula Editor and select a category, then select a symbol in the
context menu.
• Enter markup language directly in the Formula Editor.
Note
Using the Elements panel or the context menus to create a formula provides a
convenient way to learn the markup language used by LibreOffice Math.
Tip
When using the Elements panel, it is recommended to have Extended Tips selected
in the LibreOffice Options. This will help you identify the categories and symbols you
can use in the formula. Go to Tools > Options > LibreOffice > General on the
Menu bar and select Extended Tips in the Help section.
Note
The Elements panel can either be a floating dialog, as shown in Figure 4, or
positioned to the left of the Formula Editor, as shown in Figure 1 and Figure 3.
Tip
The Elements panel includes an Examples category which provides example
formulas to use as a starting point for your formula or equation.
Context menu
The Formula Editor also provides a context menu to access categories and symbols when
creating a formula. Right-click in the Formula Editor to open the context menu. Select a category
and then select the markup example that you want to use in the sub-context menu. An example
is shown in Figure 5.
Note
The Elements panel and the context menu contain only the most common
commands that are used in formulas. To insert other symbols and commands not
listed in the Elements panel and context menu, you have to enter them manually
using the markup language. For a complete list of commands and symbols available
in Math, see Appendix A, Commands Reference.
Markup language
Markup language is entered directly into the Formula Editor. For example, typing 5 times 4
into the Formula Editor creates the simple formula 5×4 . If you are experienced in using markup
language, it can be the quickest way to enter a formula. Table 2 shows some examples of using
markup language to enter commands. For a full list of commands that can be used in the
Formula Editor, see Appendix A, Commands Reference.
Table 2: Example commands using markup language
Display Command Display Command
a=b a = b √a sqrt {a}
2
a a^2 an a_n
Greek characters
Using markup language
Greek characters are commonly used in formulas, but they cannot be entered into a formula
using the Elements panel or the context menu. Use the English names of Greek characters in
markup language when entering Greek characters into a formula. See Appendix A, Commands
Reference for a list of characters that can be entered using markup language.
Symbols dialog
Greek characters can also be entered into a formula using the Symbols dialog.
1) Make sure your cursor is in the correct position in the Formula Editor.
2) Go to Tools > Symbols on the Menu bar, or click the Symbols icon in the Tools toolbar,
to open the Symbols dialog (Figure 6)
3) Select Greek in the Symbol set drop-down list. For italic characters, select iGreek in the
drop-down list.
4) Double-click the Greek character you want to insert, or select it and click Insert. When
selected, the name of the character is shown below the symbol list.
5) Click Close when you have finished entering Greek characters into your formula.
Formula examples
Example 1
The simple formula 5×4 can be created using LibreOffice Math as follows:
1) Make sure your cursor is flashing in the Formula Editor, then select the category
Unary/Binary Operators and symbol Multiplication using one of the following methods:
– In the Elements panel, select Unary/Binary Operators from the drop-down list and
then select the Multiplication icon .
Tip
To move forward from one placeholder to the next placeholder in a formula, press
the F4 key. To move backward from one placeholder to the previous placeholder in a
formula, use the key combination Shift+F4.
Note
If necessary, you can prevent a formula in a document from updating automatically.
Go to View on the Menu bar and deselect AutoUpdate Display. To then manually
update a formula, press the F9 key or select View > Update on the Menu bar.
Example 2
You want to enter the formula π ≃ 3.14159 , where the value of pi is rounded to 5 decimal
places. You know the name of the Greek character (pi), but do not know the markup associated
with the Is Similar Or Equal symbol ≃ .
1) Make sure your cursor is flashing in the Formula Editor.
2) Enter %pi in the Formula Editor to enter the Greek character for pi (π).
3) Select the category Relations and symbol Is Similar Or Equal using one of the following
methods:
– In the Elements panel, select Relations in the drop-down list and then select the Is
Similar Or Equal icon .
– Right-click in the Formula Editor and select Relations > a simeq b in the context
menu.
4) Delete the first placeholder <?> before the word simeq in the Formula Editor.
5) Select the second placeholder <?> after the word simeq in the Formula Editor and
replace it with the characters 3.14159. The formula π ≃ 3.14159 now appears in
your document.
Editing formulas
How you edit a formula and switch into formula editing mode depends on whether the formula is
in Math or another LibreOffice component.
1) In Math, double-click on a formula element in the formula that appears in the Preview
window to select the formula element in the Formula Editor, or directly select a formula
element in the Formula Editor.
Note
If you cannot select a formula element using the cursor, click on the Formula Cursor
icon in the Tools toolbar to activate the formula cursor.
2) Select the formula element you want to change using one of the following methods:
– Click on the formula element in the Preview window, positioning the cursor at the
beginning of the formula element in the Formula Editor, then select the formula
element in the Formula Editor.
– Double-click on the formula element in the Preview window to select the formula
element in the Formula Editor.
– Position the cursor in the Formula Editor at the formula element you want to edit, then
select that formula element.
– Double-click directly on the formula element in the Formula Editor to select it.
3) Make your changes to the formula element you have selected.
4) Go to View > Update on the Menu bar, or press the F9 key, or click on the Update icon
on the Tools toolbar to update the formula in the Preview window or your document.
5) In Math, save your changes to the formula after editing.
In Writer, Calc, Impress, or Draw, click anywhere in the document away from the formula
to leave editing mode, then save the document to save your changes to the formula.
Formula layout
This section provides some advice on how to lay out complex formulas in Math or in your
LibreOffice document.
Using braces
LibreOffice Math knows nothing about order of operation within a formula. You need to use
braces (curly brackets) to define the order of operations. The following examples show how
braces can be used in a formula.
Example 1
2
2 over x + 1 gives the result +1
x
Math has recognized that the 2 before and the x after the over command as belonging to
the fraction, and has represented them accordingly. If you want x +1 rather than x to
be the denominator, you must bracket them together using braces so that both will be
placed there.
2
Inserting braces into 2 over {x + 1} gives the result where x +1 is now the
x+1
denominator.
Example 2
−1
– 1 over 2 gives the result
2
matrix { a # b ## c # d } a b
c d
In matrices, rows are separated by two hashes (##) and entries within each row are separated by
one hash (#).
Normally, when you use brackets within a matrix, the brackets do not scale as the matrix
increases in size. The example below shows an a formula where the parentheses do not scale to
the size of the resulting matrix.
a b
( matrix { a # b ## c # d } ) ( )
c d
To overcome this problem, Math provides scalable brackets that grow in size to match the size of
the matrix. The commands left( and right) have to be used to create scalable brackets
around a matrix. The following example shows how to create a matrix with scalable parentheses.
left( matrix { 1 # 2 # 3 ##
4 # ` # 6 } right) ( 14 2 3
6 )
Tip
If you want all brackets to be scalable, go to Format > Spacing on the Menu bar to
open the Spacing dialog. Click on Category, select Brackets from the drop-down list.
and then select the option Scale all brackets.
Unpaired brackets
When using brackets in a formula, Math expects that for every opening bracket there will be a
closing one. If you forget to add a closing bracket, Math places an inverted question mark next to
where the closing bracket should have been placed. For example, lbrace a; b will result in
¿ because the right bracket rbrace is missing.
This inverted question mark disappears when all the brackets are paired. The previous example
could be fixed to lbrace a; b rbrace, resulting in {a ; b}. However, there are cases where an
unpaired bracket is necessary and for that you have the following options.
Scalable brackets
To create unpaired scalable brackets or braces in a formula, the markup commands left,
right, and none can be used.
Example
The following formula uses the stack command to create a two-line formula and adds a
bracket only to the right side of the stack.
Recognizing functions
In the basic installation of Math, Math outputs functions in normal characters and variables in
italic characters. However, if Math fails to recognize a function, you can tell Math that you have
just entered a function. Entering the markup command func before a function forces Math to
recognize the following text as a function.
For a full list of functions within Math, see Appendix A, Commands Reference.
Tip
You can navigate through errors in a formula using the key F3 to move to the next
error or the key combination Shift+F3 to move to the previous error.
x = 3 newline y = 1
x=3
y=1
It is not possible in Math to create multiple line formulas when a line ends with an equals sign
and you want to continue the formula on a new line without completing the term on the right side
of the equals sign. If you require a multiple line formula to have an equals sign at the end of a line
without a term after the equals sign, then use empty quotes “” or empty braces {} or the space
characters grave ` or tilde ˜.
By default, the alignment of a multiple line formula is center aligned. For more information on
alignment using the equals sign, see “Aligning formulas using equals sign” on page 24.
x
int from 0 to x f(t) dt ∫ f (t) dt
0
x
int_0^x f(t) dt ∫0 f (t )dt
int from Re f ∫ℜ f
Writing derivatives
When writing derivatives, you have to tell Math that it is a fraction by using the over command.
The over command is combined with the character d for a total derivative or the partial
command for a partial derivative to achieve the effect of a derivative. Braces {} are used in each
side of the elements to surround them and make the derivative as shown by the following
examples.
Examples
Below are a few examples of how you can use Math to write derivatives:
Markup Language Resulting Formula
df
{df} over {dx}
dx
∂f
{partial f} over {partial y}
∂y
2
∂ f
{partial^2 f} over {partial t^2} 2
∂t
Note
To write function names with primes, as is normal in school notation, you must first
add the symbols to the catalog. See “Catalog customization” on page 50 for more
information.
Note
The Special Characters dialog used by other LibreOffice components is not available
in Math. If you regularly require special characters in Math, then it is recommended
to add the characters to the Math Catalog. See “Catalog customization” on page 50
for more information.
Text in formulas
To include text in a formula, you have to enclose any text in double-quotes, for example x "
for " x >= 0 in markup language will create the formula x for x≥0 . All characters, except
double quotes, can be used in text.
However, if you require double quotes in formula text, then you have to create your text with
double quotes in LibreOffice Writer, then copy and paste the text into the Formula Editor as
shown in Figure 7.
Note
The empty braces each side of the equals sign are necessary because the equals
sign is a binary operator and requires an expression on each side. You can use
spaces, or ` or ~ characters each side of the equals sign, but braces are
recommended as they are easier to see within the markup language.
You can reduce the spacing on each side of the equals sign if you change the inter-column
spacing of the matrix. See “Adjusting formula spacing” on page 28 for more information.
Note
If you have already inserted formulas into your document and you change the
default font or font size, only formulas inserted after the change in default font or
font size will use the new default settings. You have to individually change the font or
font size of formulas already inserted if you want these formulas to use the same font
or font size as the default settings.
Formula fonts
Current formula fonts
To change the fonts used for the current formula in Math or another LibreOffice component:
1) Click in the markup language in the Formula Editor.
2) Go to Format > Fonts on the Menu bar to open the Fonts dialog (Figure 9).
3) Select a new font for each of the various options from the drop-down lists.
4) If the font you want to use does not appear in the drop-down list, click Modify and select
the option from the context menu to open a fonts dialog. Select the font you want to use
and click OK to add it to the drop-down list for that option.
5) Click OK to save your changes and close the Fonts dialog.
Note
Variables should be written in italics, so make sure that the Italic option is selected.
For the font you want to use. For all other elements, use the basic form of a font. The
style can be easily altered in the formula itself by using the commands italic or
bold to set these characteristics and nitalic or nbold to unset them.
Spacing options
Use Category in the Spacing dialog (Figure 10) to determine the formula element for which you
would like to specify the spacing. The appearance of the dialog depends on the selected
category. A preview window shows you which spacing is modified through the respective boxes.
• Category – click this button to select the category for which you want to change the
spacing.
• Spacing – defines the spacing between variables and operators, between lines, and
between root signs and radicals.
– Spacing – determines the spacing between variables and operators
– Line Spacing – determines the spacing between lines.
– Root Spacing – determines the spacing between the root sign and radicals.
• Indexes – defines the spacing for superscript and subscript indexes.
– Superscript – determines the spacing for superscript indexes.
– Subscript – determines the spacing for subscript indexes.
• Fractions – defines the spacing between the fraction bar and the numerator or
denominator.
– Numerator – determines the spacing between the fraction bar and the numerator.
– Denominator – determines the spacing between the fraction bar and the denominator.
• Fraction Bars – defines the excess length and line weight of the fraction bar.
– Excess length – determines the excess length of the fraction line.
– Weight – determines the weight of the fraction line.
• Limits – defines the spacing between the sum symbol and the limit conditions.
– Upper limit – determines the spacing between the sum symbol and the upper limit.
– Lower limit – determines the spacing between the sum symbol and the lower limit.
• Brackets – defines the spacing between brackets and the content.
– Excess size (left/right) – determines the vertical distance between the upper edge of
the contents and the upper end of the brackets.
– Spacing – determines the horizontal distance between the contents and the upper end
of the brackets.
– Scale all brackets – scales all types of brackets. If you then enter ( a over b) in
the Formula Editor, the brackets will surround the whole height of the argument. You
normally achieve this effect by entering left ( a over b right ).
– Excess size – adjusts the percentage excess size. At 0% the brackets are set so that
they surround the argument at the same height. The higher the entered value is, the
larger the vertical gap between the contents of the brackets and the external border of
the brackets. The field can only be used in combination with Scale all brackets.
• Matrices – defines the relative spacing for the elements in a matrix.
Note
If you are adding Math formulas into a LibreOffice Writer document, you may notice
spacing between the formula and the surrounding text even if you set all formula
borders to zero. This is because Math formulas are OLE objects embedded into a
frame that, by default, adds 0.2 cm to the left and right of the Math object.
You can remove that extra spacing in two ways. The first way is to edit the object
properties by right-clicking the Math object and then going to Properties > Wrap and
adjust the Spacing fields to the desired values. The second way is to modify the
spacing options of the default Formula frame style or create a new style. To learn
more on how to change the spacing of Math objects, refer to “Object spacing” on
page 38. For more information on how to edit styles in general, refer to the Styles
chapters in the Writer Guide.
Example
In the following example, Math objects are combined with text by removing all spacing both
from the formula and the frame style surrounding it. Because spacing is set to zero, the
spacing between text and formulas is achieved by simply adding a space character using
the keyboard space bar.
“Let c ij be a cost matrix and x ij ∈{0 ; 1 } be a decision variable defined for i=1,2 , ..., m
origins and for j=1,2 ,... , n destinations”.
Note
Regardless of the alignment option selected in the Alignment dialog, it is possible to
align sections of a formula using the commands alignl, alignc and alignr. For
example, they can be useful to align formulas in matrices. These commands also
work for text elements.
Note
If you have already inserted formulas into a document and you change the formula
alignment, only formulas inserted after the change in alignment will use the new
default settings. You have to individually change the alignment of formulas already
inserted if you want them to use the same alignment as the default settings.
Named colors
For information on the named colors available in Math, see “Attributes” on page 64. These colors
are listed in the Attributes section of the Elements panel (Figure 4 on page 14).
RGB values
To use custom colors defined by RGB (Red, Green and Blue) values ranging from 0 to 255, use
the color rgb R G B markup command, where R, G, and B correspond to the Red, Green,
and Blue values of the desired color.
Example
In this example, the term “decision variable” uses the color defined by the RGB values 160,
82, 45.
"Let " x_ij " be a " color rgb 160 82 45 "decision variable " "in
the problem under consideration"
Math will create the following output:
Let x ij be a decision variable in the problem under consideration
Hex values
Math now supports HTML colors, defined by a hex number. Use the color hex 000000
markup command, where 00000 is the corresponding hex number. For example, the command
color hex FF0000 decision creates the output decision .
Background color
It is not possible to select a background color for formulas in LibreOffice Math. The background
color for a formula is by default the same color as the document or frame that the formula has
been inserted into. In LibreOffice Writer, you can use object properties to change the background
color for a formula. For more information, see “Background and borders” on page 39.
Formula library
If you regularly insert the same formulas into your documents, you can create a formula library
using formulas that you have created using the Formula Editor. Individual formulas can be saved
as separate files using the ODF format for formulas (file type .odf), or in MathML format (file
type .mml).
You can use either LibreOffice Math, Writer, Calc, Draw, or Impress to create formulas and build
up your formula library.
Using Math
1) Create a folder on your computer to contain your formulas and give the folder a
memorable name, for example Formula Library.
Note
MathML 2.0 stands for Mathematical Markup Language (MathML) Version 2.0.
MathML is an XML format that describes mathematical notation and enables the use
of mathematics in the World Wide Web. If you want to learn more about the MathML
format, visit its official website at https://www.w3.org/TR/MathML2/overview.html
Chapter 2,
Formulas in Writer
Introduction
When a formula is inserted into a document, LibreOffice Writer inserts the formula into a frame
and treats the formula as an OLE object. Double-clicking on an inserted formula will open the
Formula Editor in LibreOffice Math, allowing you to edit the formula. For more information on
creating and editing formulas, please refer to Chapter 1, Creating and Editing Formulas.
This chapter explains what options you can change for each individual formula within a Writer
document. Please refer to the chapters on styles in the Writer Guide for information on how to
change the default settings for frame styles for OLE objects.
Numbering
1) Start a new line in your document.
2) Type fn and then press the F3 key. A two column table with no borders is inserted into
your document with the left column containing a sample formula and the right column
containing a reference number, as shown below.
2 (1)
E=mc
3) Delete the sample formula and insert your formula as an object in the left column.
4) Alternatively, you can first insert your formula into the document, then carry out Steps 1
and 2 above replacing the sample formula with your formula.
Cross-referencing
1) Click in your document where you want the cross-reference to appear.
2) Go to Insert > Cross-reference on the Menu bar to open the Fields dialog (Figure 12).
3) Click on the Cross-references tab, then select Text in the Type section.
4) In the Selection section, select the formula number you want to refer to.
5) In the Insert reference to section, select Reference and click Insert.
6) When you have finished creating cross-references, click Close to close the Fields dialog.
Tip
To insert the cross-reference number without parentheses, select Numbering instead
of Reference in the Insert reference to section.
Note
If you want to use square parentheses instead of round ones, or if you want the
cross-reference number to be separated from the formula by tabs instead of using a
table, then refer to the Writer Guide.
Anchoring formulas
A formula is treated as an object within Writer and its default anchoring is To character within a
paragraph when it is inserted into a document. To change the anchoring of a formula object:
1) Right-click on the selected formula object and select Anchor from the context menu.
2) Select a new anchoring option from the context sub-menu. The anchoring positions
available are To page, To paragraph, To character, or As character.
3) Alternatively, right-click on the selected formula object and select Properties from the
context menu, or go to Format > Frame and Object > Properties on the Menu bar to
open the Object dialog (Figure 13).
4) Make sure the Type tab is selected and select a new anchoring position from the Anchor
section.
5) Click OK to save your changes and close the Object dialog.
Note
The anchoring options are not available in the Object dialog when you are making
changes to the options available for frame styles. For more information on how to
modify frame styles, please refer to the chapters on styles in the Writer Guide.
Vertical alignment
The normal default setting for vertical alignment for formula objects is to use the text base line as
a reference. This default setting can be changed by modifying the Formula frame style; see the
chapters on styles in the Writer Guide for more information.
To change the vertical alignment position of an individual formula object (assuming that the As
character anchoring option is selected):
1) Right-click on the selected formula object and select Properties in the context menu, or
go to Format > Frame and Object > Properties to open the Object dialog (Figure 13).
2) Make sure the Type tab is selected and select a new alignment position in the drop-down
list in the Position section. The vertical alignment options available are Top, Bottom,
Center, or From bottom.
3) If necessary, type in the text box a plus or minus value for vertical alignment. This option
is only available if From bottom vertical alignment has been selected.
4) Select the type of text alignment from the drop-down list in the Position section. The text
alignment options available are Base line, Character, and Row.
5) Click OK to save your changes and close the Object dialog.
Note
If the Position section in the Object dialog is grayed out and not available, then go to
Tools > Options > LibreOffice Writer > Formatting Aids and uncheck the option
Math baseline alignment. This setting is stored with the document and applies to all
formulas within it. Any new documents created will also use this setting for Math
baseline alignment.
Note
Object wrapping options will be grayed out if the object is anchored As Character. To
enable all wrapping options, you need to anchor the object To Page, To Paragraph,
or To Character. To change the anchor settings, right-click the formula object and
use the Anchor context menu to select the desired option.
∑ i2
i=2
and the same formula embedded into a line of text using text mode format: ∑5i=2 i 2
Note
The size of the frame that a formula is placed in when inserted into a document
cannot be changed. The frame size for a formula object depends on the setting of
the formula font size. See “Formula font size” on page 25 for more information.
∑ wi y i
i=1
Note that the background color and border properties are part of the Math OLE object and hence
cannot be defined using markup language.
Backgrounds
1) In your document, select the formula where you want to change the background.
2) Right-click on the formula and select Properties from the context menu, or go to Format
> Frame and Object > Properties on the Menu bar to open the object dialog.
3) Click on the Area tab and use the buttons at the top to select the type of fill you want to
use for your formula (Figure 15).
4) Select the options you want to use for your formula background. The options change
depending on the type of fill selected.
5) Click OK to save your changes and close the Object dialog.
Borders
1) In your document, select the formula where you want to change the borders.
2) Right-click on the formula and select Properties from the context menu, or go to Format
> Frame and Object > Properties on the Menu bar to open the object dialog.
3) Click on the Borders tab and select the options you want to use for your formula borders
(Figure 16). Click OK to save your changes and close the Object dialog.
Chapter 3,
Formulas in Calc, Draw, and
Impress
Introduction
In Calc, Draw, and Impress, formulas are inserted as OLE objects without any background (area
fill) or borders. See Chapter 1, Creating and Editing Formulas for more information on inserting
formulas into a LibreOffice component.
Each formula object is inserted into a spreadsheet, drawing, or slide as follows:
• In Calc, formulas are inserted into a selected cell in a spreadsheet with no style assigned
to the formula object.
• In Draw and Impress, formulas are inserted into a central position on your drawing or
slide and, by default, are assigned the drawing object style Object with no fill and no line.
For more information on how to modify or assign drawing object styles, see the Draw
Guide or the Impress Guide.
Anchoring formulas
Calc
A formula object can be anchored into a spreadsheet as To Page (default setting), or as To Cell.
To change the anchoring type of formulas in a Calc spreadsheet:
1) Select the formula object in the spreadsheet.
2) Right-click on the formula and select Anchor > To Page or To Cell in the context menu.
3) Alternatively, go to Format > Anchor on the Menu bar and select To Page or To Cell.
Tip
If you insert a formula into a Calc spreadsheet and it appears out of scale, you can
fix it by right-clicking the formula object and then selecting the Original Size option
in the context menu.
Formulas in charts
A chart in a Calc spreadsheet is itself an OLE object, therefore, you cannot use the Formula
Editor to create and insert a formula directly into a chart. However, you can create both the Chart
and Math objects separately and later copy and paste the Math formula into the Chart object:
1) Create the chart using LibreOffice Calc. For a complete reference on how to create
charts, see Chapter 3 in the Calc Guide.
2) Click at any cell in your spreadsheet so that the Chart is no longer selected.
3) Insert a Math Formula object by clicking Insert > Object > Formula.
4) Type the desired formula into the Formula Editor.
5) After editing the formula, select the Math Formula object and press Ctrl+C to copy the
Formula object to the clipboard.
6) Double-click the chart object to start editing the chart and press Ctrl+V to paste the
Formula object into the chart.
7) Now you can position the object anywhere you want inside the chart.
Figure 17 shows an example of a Calc chart with a Math Formula object inside it, which in this
example is the sin(x ) function.
1.5
sin (x)
0.5
-0.5
-1
-1.5
0 50 100 150 200 250 300 350
Figure 17: Calc chart with a Math object inside it
To change the formula, you must repeat the whole process of creating, copying, and pasting the
Formula object into the chart.
To create chemical formulas using Math, change the font used for variables to a non-italic font.
For more information on how to change fonts in a formula, see “Formula fonts” on page 26.
For reversible reactions in chemical formulas, there is no symbol for a double arrow in Math. If
you have a font available with correct symbols for use in chemical formulas, then you can add
these symbols to the Catalog. See “Catalog customization” on page 50 for more information on
how to add symbols to the Catalog.
Chapter 4,
Customization
Introduction
This chapter explains how you can customize LibreOffice Math to suit the way you create
formulas for use in LibreOffice documents. Also, refer to Chapter 14, Customizing LibreOffice, in
the Getting Started Guide for more general information on how to customize LibreOffice.
Floating dialogs
The Formula Editor and Elements panel can cover a large part of your document. To help create
more space and/or allow you to move either the Formula Editor or Elements panel out of the way,
you can turn both of them into floating dialogs.
1) Position the cursor on the frame.
2) Hold down the Ctrl key and double-click. This turns the Formula Editor into the
Commands dialog (Figure 18) and the Elements panel into the Elements dialog (Figure
19).
Caution
When selecting new keyboard shortcuts, make sure that you do not select a
shortcut that is already in use by LibreOffice or your computer system.
Chapter 4, Customization | 47
Example keyboard shortcut
1) Go to Tools > Customize on the Menu bar to open the Customize dialog (Figure 20).
2) Click on the Keyboard tab to access the options available for adding keyboard shortcuts.
Chapter 4, Customization | 49
Catalog customization
If you regularly use a symbol that is not available in Math, you can add it to the Symbols dialog
(Figure 22) by using the Edit Symbols dialog (Figure 23).
You can add symbols to a symbol set, edit symbol sets, or modify symbol notations. You can also
define new symbol sets, assign names to symbols, or modify existing symbol sets.
Adding symbols
1) Go to Tools > Symbols on the Menu bar or click on the Symbols icon on the Tools
toolbar to open the Symbols dialog (Figure 22).
2) Click the Edit button to open Edit Symbols dialog (Figure 23).
3) Select a font in the Font drop-down list.
4) Select a symbol character that you want to add in the preview box. You may have to scroll
down in the preview box to locate the symbol you want to use. The small right preview
box displays the new symbol.
5) In the Symbol box, type a memorable name for the symbol you are adding.
6) In the Symbol set box, select a symbol set in the drop-down list to add your new symbol
to, or type a new name to create a new symbol set for your new symbol.
7) If required, select a font style from the Style drop-down list – Standard, Italic, Bold, or
Bold Italic.
8) Click Add, then click OK to close the Edit Symbols dialog. The new symbol and, if
created, new symbol set are now available for use.
Note
When a new symbol is added to the catalog, you can type a percentage sign (%)
followed by the new name into the markup language in the Formula Editor and your
new symbol will appear in the formula. Remember that symbol names are case
sensitive, for example, %prime is a different symbol to %Prime.
Note
There are numerous free fonts available that contain several symbols if you cannot
find a symbol to use in the fonts already installed on your computer. For example,
the STIX font was developed specially for writing mathematical and technical texts.
Also, the DejaVu and Lucida fonts have a wide range of symbols.
Note
By default, only those user-defined symbols that actually occur in the document are
stored with it. Sometimes it is useful to embed all the user-defined symbols, so that
when the document is transferred to another computer it can be edited by another
person. Go to Tools > Options > LibreOffice Math > Settings on the Menu bar and
uncheck Embed only used symbols (smaller file size) in the Miscellaneous
Options setion.
Editing symbols
Modifying symbol names
To change the name of a symbol:
Chapter 4, Customization | 51
1) In the Edit Symbols dialog (Figure 23), select the symbol name you want to change from
the Old symbol drop-down list. The symbol appears in the left preview pane at the bottom
of the dialog.
2) Type a new name for the symbol in the Symbol text box, or select a new name in the
Symbol drop-down list. The new symbol name appears above the right preview pane at
the bottom of the Edit Symbols dialog.
3) Click Modify and the symbol name is changed.
4) Click OK to close the Edit Symbols dialog.
Moving symbols
To move a symbol from one symbol set to another:
1) In the Edit Symbols dialog (Figure 23), in the Old symbol set drop-down list, select the
symbol set where the symbol you want to move is located.
2) Select the symbol name you want move in the Old symbol drop-down list. The symbol
appears in the left preview pane at the bottom of the Edit Symbols dialog.
3) In the Symbol set drop-down list, select the symbol set that you want to move the symbol
to. The new symbol set name appears below the right preview pane at the bottom of the
Edit Symbols dialog.
4) Click Modify and the symbol is moved to the new symbol set.
5) Click OK to close the Edit Symbols dialog.
Deleting symbols
To delete a symbol from a symbol set:
1) In the Edit Symbols dialog (Figure 23), in the Old symbol set drop-down list, select the
symbol set from which you want to delete the symbol.
2) Select the symbol name you want to delete in the Old symbol drop-down list. The symbol
appears in the left preview pane at the bottom of the Edit Symbols dialog (Figure 23).
3) Click Delete and the symbol is deleted from the symbol set without any confirmation.
4) Click OK to close the Edit Symbols dialog.
Note
The only way you can delete a symbol set is by deleting all of the symbols in that set.
When you delete the last symbol from a set, the set is also deleted.
Formula spacing
The grave accent (`) inserts an additional small space and the tilde (~) inserts an additional large
space into formulas. However, in the basic installation of LibreOffice, these symbols are ignored
when they occur at the end of a formula. If you are working with running text in a formula, it may
be necessary to include spacing at the end of formulas as well. This customization is only
required when you are working with a Math document and is not required when you are inserting
a formula into another LibreOffice component.
To add spacing at the end of formula in Math, go to Tools > Options > LibreOffice Math >
Settings on the Menu bar and uncheck Ignore ~ and ` at the end of the line in the
Miscellaneous Options section.
Note
To customize LibreOffice Math settings, you need to start LibreOffice Math and then
navigate to Tools > Options > LibreOffice Math > Settings.
Extensions
If you create formulas frequently in your documents, you can customize LibreOffice by adding
extensions that are designed to help you create formulas. Extensions are easily installed using
Chapter 4, Customization | 53
the Extension Manager. For more information on how to install extensions, see Chapter 14,
Customizing LibreOffice, in the Getting Started Guide.
A commonly used extension is Formatting of All Math Formulas. It allows you to format all
Math formulas in a Writer, Calc, Draw, or Impress document. With it you can change the font
names and font sizes of all formulas in the document. For more information on this extension, go
to https://extensions.libreoffice.org/en/extensions/show/formatting-of-all-math-formulas.
Chapter 5,
Exporting and Importing
MathML format
In addition to exporting documents as PDFs, as described in the Getting Started Guide,
LibreOffice offers the possibility of exporting formulas in the MathML format. This allows you or
another person to insert formulas into documents that were created in other software, for
example, Microsoft Office or an internet browser.
Note
Some internet browsers do not fully support the MathML format and your formula
may not display correctly.
If you are working on a Math document, go to File > Save as on the Menu bar or use the
keyboard combination Ctrl+Shift+S to open the Save as dialog. Select MathML from the list of
available file formats in File type to save your formula as MathML.
If you are working in another LibreOffice component, right-click on the formula object and select
Save copy as from the context menu to open the Save as dialog. Select MathML from the list of
available file formats in File type to save your formula object as MathML.
In Math you can also import MathML formulas. Use Tools > Import MathML from clipboard on
the Menu bar.
Appendix A,
Commands Reference
Introduction
This appendix lists the operators and commands that are available for use in the Formula Editor
when you are creating formulas.
The more common operators and commands can be entered by clicking on the appropriate icon
in the Elements panel. Where there is no icon displayed in the following tables for the Elements
panel, then you have to enter the operator or command into the Formula Editor using markup
language.
Note
In the markup language shown in the following tables, you have to replace the place
holder <?> with the value you want to use in your formulas.
Relation commands
To access the icons used for entering markup language for relations commands into the Formula
Editor, select Relations from the drop-down list at the top of the Elements panel.
Table 4: Relation commands
Operation Markup language Example formula
Is equal <?> = <?> A=B
Is not equal <?> <> <?> or <?> neq <?> A≠B
Is less than <?> < <?> or <?> lt <?> A <B
Is less than or equal to <?> <= <?> A≤B
Is less than or equal to <?> leslant <?> A⩽B
Is greater than <?> > <?> or <?> gt <?> A >B
Is greater than or equal to <?> >= <?> A≥B
Is greater than or equal to <?> geslant <?> A⩾B
Is much less than <?> << <?> or <?> ll <?> A ≪B
Is much greater than <?> >> <?> or <?> gg <?> A ≫B
Is approximately equal <?> approx <?> A≈B
Is similar to <?> sim <?> A∼B
Is similar to or equal <?> simeq <?> A≃B
Is congruent to <?> equiv <?> A≡B
Is proportional to <?> prop <?> A∝B
Is parallel to <?> parallel <?> A∥B
Is orthogonal to <?> ortho <?> A⊥B
Divides <?> divides <?> A∣B
Does not divide <?> ndivides <?> A ∤B
Toward <?> toward <?> A →B
Double arrow left <?> dlarrow <?> A⇐B
Double arrow left and right <?> dlrarrow <?> A⇔B
Double arrow right <?> drarrow <?> A ⇒B
Functions
To access the icons used for entering markup language for function commands into the Formula
Editor, select Functions from the drop-down list at the top of the Elements panel.
Table 6: Function commands
Operation Markup language Example formula
Absolute value abs{<?>} |A|
Factorial fact{<?>} A!
Square root sqrt{<?>} √A
A
Nth root nroot{<?>}{<?>} √B
B
Power <?>^{<?>} A
A
Natural exponential function func e^{<?>} e
Natural logarithm ln(<?>) ln ( A)
Exponential function exp(<?>) exp( A)
Logarithm log(<?>) log( A)
Sine sin(<?>) sin( A)
Cosine cos(<?>) cos ( A)
Tangent tan(<?>) tan( A)
Cotangent cot(<?>) cot ( A)
Hyperbolic sine sinh(<?>) sinh ( A)
Hyperbolic cosine cosh(<?>) cosh ( A)
Hyperbolic tangent tanh(<?>) tanh( A )
Hyperbolic cotangent coth(<?>) coth( A)
Inverse sine or arcsine arcsin(<?>) arcsin ( A)
Inverse cosine or arccosine arccos(<?>) arccos ( A)
Inverse tangent or arctangent arctan(<?>) arctan ( A)
Inverse cotangent or arccotangent arccot(<?>) arccot ( A )
Inverse or area hyperbolic sine arsinh(<?>) arsinh ( A )
Inverse or area hyperbolic cosine arcosh(<?>) arcosh ( A)
Inverse or area hyperbolic tangent artanh(<?>) artanh ( A)
Inverse or area hyperbolic cotangent arcoth(<?>) arcoth ( A)
Back epsilon backepsilon ∍
Operators
To access the icons used for entering markup language for operator commands into the Formula
Editor, select Operators from the drop-down list at the top of the Elements panel.
Table 7: Operator commands
Operation Markup language Example formula
Limes lim <?> lim A
Limes subscript bottom lim from{<?>} <?> lim B
A
A
Limes superscript top lim to{<?>} <?> lim B
B
Limes sup/sub script lim from{<?>} to{<?>} <?> lim C
A
OP
0
A .
Attributes
To access the icons used for entering markup language for attribute commands into the Formula
Editor, select Attributes from the drop-down list at the top of the Elements panel, or click the
Attributes icon in the Elements dialog.
Table 8: Attribute commands
Operation Markup language Example formula
Acute accent acute <?> Á
Grave accent grave <?> À
Breve breve <?> Ă
Circle circle <?> Å
Dot dot <?> Ȧ
Double dot ddot <?> Ä
Triple dot dddot <?> ⃛
A
Line above bar <?> Ā
Vector arrow vec <?> ⃗
A
Harpoon harpoon <?> ⃑
A
tilde <?> ~
Tilde A
Circumflex hat <?> A^
Reverse circumflex check <?> Ǎ
Large vector arrow widevec {<?>} ⃗
AB
Large harpoon wideharpoon <?> ⃑
AB
widetilde {<?>} ~
Large tilde AB
Large circumflex widehat {<?>} ^
AB
Line over overline {<?>} AB
Line below underline {<?>} AB
Line through overstrike {<?>} AB
Transparent (blank phantom {<?>} A B
placeholder to create space)
Bold font bold <?> AB
Not bold font nbold <?> AB
Italic font ital <?> or italic <?> AB
Not italic font nitalic <?> AB
Note
The font command changes the font type. The first placeholder is replaced with the
name of the font and the second placeholder is replaced with your formula values or
text. The default fonts are Serif, Sans, or Fixed. If you have added custom fonts to
Math (see “Formula fonts” on page 26), then you can replace the first placeholder
with the custom font name.
Formats
To access the icons used for entering markup language for format commands into the Formula
Editor, select Formats from the drop-down list at the top of the Elements panel.
Table 10: Format commands
Operation Markup language Example formula
<?>^{<?>} or <?>sup{<?>} or 10
Power (superscript right)
<?>rsup{<?>} 20
<?>_{<?>} or <?>sub{<?>} or
Subscript right 2010
<?>rsub{<?>}
10
Superscript left <?>lsup{<?>} 20
Subscript left <?>lsub{<?>} 10 20
10
Superscript center <?>csup{<?>} 20
newline
123
New line
CD
Small gap ` 123 456
Blank or large gap ~ 123 456
No space (suppresses
space between elements)
nospace {<?>} 12+4+5
alignl <?>
ABC
Align left
D
alignc <?>
ABC
Align center
D
alignr <?>
ABC
Align right
D
binom{<?>}{<?>}
AB
Vertical stack (2 elements)
12
AB
Vertical stack (more than 2
elements)
stack{<?> # <?> # <?>} 12
CD
matrix{<?> # <?> ## <?> # AB 12
Matrix stack
<?>} 34 CD
Note
By default, text characters are aligned to the center in a formula. Use the alignl
and alignr commands to align text characters in a formula to the left or right when
a formula has more than one line. You can also use the align commands in
conjunction with the stack commands to align multi-line formulas on a specific
formula element, for example, the equals sign (=).
Others
To access the icons used for entering markup language for other commands into the Formula
Editor, select Others from the drop-down list at the top of the Elements panel, or click the Others
icon in the Elements dialog.
Table 11: Other commands
Operation Markup language Example formula
Placeholder <?>
Infinity infinity or infty ∞
Partial derivative or set margin partial ∂
Nabla vector operator nabla ∇
Existential quantifier, there is at
least one
exists ∃
Existential quantifier, there does
not exist
notexists ∄
Greek characters
Greek characters are normally entered into a formula using the Symbols dialog (see “Greek
characters” on page 15 for more information). However, if you know the name of the Greek
character, you can type a percentage sign (%) followed by the name of the Greek character into
the Formula Editor.
For uppercase Greek characters, type the name using uppercase characters, for example
%BETA Β (see Table 12 for a full list of uppercase Greek characters). For lowercase Greek
characters, type the name using lowercase characters, for example %beta β (see Table 13 for a
full list of lowercase Greek characters)
Italic Greek characters can also be entered into a formula by typing the character i after the
percentage sign (%) and before the name of the Greek character, for example, %iPI Π for
uppercase and %ipi for lowercase π . See Table 14 for a full list of italic uppercase Greek
characters and Table 15 for a full list of italic lowercase Greek characters.
Note
In localized versions of LibreOffice, the names of Greek characters are also
localized. If a document is not localized to the same language, then the names of
Greek characters in the following tables may not work correctly. If this happens, you
can use the Symbols dialog to select the required Greek character. When selected in
the Symbols dialog, the name of the Greek character is displayed at the bottom of
the Symbols dialog in the correct language. See “Greek characters” on page 15 for
more information on Greek characters and the Symbols dialog.
Special characters
Special characters are normally entered into a formula using the Symbols dialog (see “Symbols
dialog” on page 16 and “Catalog customization” on page 50 for more information). However, if
you know the name of the special character, you can type a percentage sign (%) followed by the
name of the special character into the Formula Editor. Table 16 Shows the full list of special
characters that are available in LibreOffice.
Reserved words
A reserved word is a word that is used by LibreOffice as a command in the Math markup
language and it cannot be used as a variable name or entered into a formula as text. However, if
you want to use a reserved word as text in a formula then you must place the reserved word
between double quotes.
For example, consider that you want to use the word “purple” in a formula and you do not want
the formula elements to be changed to the color purple. If you simply type A purple B in the
Formula Editor, the resulting formula is A ¿ B , which is incorrect and the error is shown by the
inverted question mark. To correct this error, type A "purple" B in the Formula Editor using
double quotes each side of the word purple and the resulting correct formula is A purple B .
If you want the word “purple” written in italic, as you would normally have with variables, you can
type A italic{ "purple" } B in the formula editor, which will result in A purple B .
The reserved words used in Math are listed in the above tables for commands in markup
language.
About LibreOffice:
LibreOffice is the free, libre, and open source personal productivity suite from The
Documentation Foundation. It runs on Windows, macOS, and GNU/Linux. Support
and documentation is free from a large, dedicated community of users, contributors,
and developers.
Get involved as a volunteer and work in many areas: development, quality
assurance, documentation, translation, user support, and more.
Download LibreOffice for free from:
https://libreoffice.org/downloads/