• LaTex2Web logo

    LaTeX2Web, a web authoring and publishing system

    If you see this, something is wrong

    • Collapse and expand sections

    To get acquainted with the document, the best thing to do is to select the "Collapse all sections" item from the "View" menu. This will leave visible only the titles of the top-level sections.

    Clicking on a section title toggles the visibility of the section content. If you have collapsed all of the sections, this will let you discover the document progressively, from the top-level sections to the lower-level ones.

    Cross-references and related material

    Generally speaking, anything that is blue is clickable.

    Clicking on a reference link (like an equation number, for instance) will display the reference as close as possible, without breaking the layout. Clicking on the displayed content or on the reference link hides the content. This is recursive: if the content includes a reference, clicking on it will have the same effect. These "links" are not necessarily numbers, as it is possible in LaTeX2Web to use full text for a reference.

    Clicking on a bibliographical reference (i.e., a number within brackets) will display the reference.

    Speech bubbles indicate a footnote. Click on the bubble to reveal the footnote (there is no page in a web document, so footnotes are placed inside the text flow). Acronyms work the same way as footnotes, except that you have the acronym instead of the speech bubble.

    Discussions

    By default, discussions are open in a document. Click on the discussion button below to reveal the discussion thread. However, you must be registered to participate in the discussion.

    If a thread has been initialized, you can reply to it. Any modification to any comment, or a reply to it, in the discussion is signified by email to the owner of the document and to the author of the comment.

    Publications

    The blue button below that says "table of contents" is your tool to navigate in a publication.

    The left arrow brings you to the previous document in the publication, and the right one brings you to the next. Both cycle over the publication list.

    The middle button that says "table of contents" reveals the publication table of contents. This table is hierarchical structured. It has sections, and sections can be collapsed or expanded. If you are a registered user, you can save the layout of the table of contents.

    Table of contents

    First published on Tuesday, Sep 2, 2025 and last modified on Wednesday, Sep 24, 2025

    I am normally hidden by the status bar

    Macros

    François Chaplais

    1 Introduction

    Macros are a programmatic way of defining “shortcuts” in LaTeX. Macros should be defined in the preamble of a document.

    2 Simple macros

    Simple macros act really like shortcuts. Here is the syntax.

    \newcommand{macro name}{macro definition}

    For instance, if I define the \lturl to be a macro that creates a link to the LaTeX2Web home page, I can do it as follows.

    \newcommand{\lturl}{\url{https://latex2web.app/}}

    every instance of \lturl will compile as https://latex2web.app/ .

    3 Complex macros

    Complex macros accept parameters. Here is the syntax.

    \newcommand{macro name}[digit]{macro definition}

    Here digit is a digit that indicates the number of parameters.

    When the macro is executed, for any digit x smaller or equal to digit, any occurence of the string #x in the macro definition will be replaced by the parameter that has been passed to the macro at parsing time. To execute a macro named \macroName in the document, it must be used as follows.

    \macroName{arg1}{arg2}....

    Let us give a practical example. In LaTeX, there is no command to style directly a text in bold and italic at the same time. We implement this as a macro. Here is the definition.

    \newcommand{\bi}[1]{\bf{\em{#1}}}

    The following code \bi{bold italic} will result in bold italic .

    4 Recursivity

    Macros can be used in the definition of other macros. For instance, let us say that we want to define bold italic style at a \large size. We can do as follows.

    \newcommand{\bil}[1]{\large{\bi{#1}}}

    The command \bil{large bold italic} will result in large bold italic.

    5 Summary

    Macros are defined in the preamble using the \newcommand command. The syntax for defining a simple macro is

    \newcommand{macro name}{macro definition}

    The syntax to define a macro that accepts parameters is

    \newcommand{macro name}[digit]{macro definition}