### 28.1.1 Defining macros

To define a macro, create a configuration-file section with the name of the macro as the section name. This section can go in your project configuration file, or in a macro library file; see §28.1.1.2 Understanding where you can define named macros.

For example, to define macro $OurLogo for HTML output:

[OurLogo]

<hr /><br /><img src="ourlogo.jpg" /><br /><hr /><br />

The content of the macro begins on the next line after the section name, and ends at the start of the next section, or at the end of the configuration file. The name must consist only of letters and digits. Do not include punctuation or spaces in a macro name.

In this section:

§28.1.1.1 Understanding what a macro definition can include

§28.1.1.2 Understanding where you can define named macros

§28.1.1.3 Escaping special characters in macro definitions

§28.1.1.4 Managing line breaks in macro definitions

§28.1.1.5 Including comments in macro definitions

§28.1.1.6 Including cross references in macro definitions

§28.1.1.7 Converting “smart quotes” in macro definitions

§28.1.1.8 Obtaining RTF code for macro definitions

| 28.1 Defining and invoking macros |  | 28.1.1.1 Understanding what a macro definition can include |