---
title: "DITA: Notes"
date: 2014-12-27
description: "{% highlight xml %}Don't fasten the bolts too tightly. First make sure all the pieces fit well together, and then tighten them down firmly.{%..."
canonical_url: https://idratherbewriting.com/notes/index.html
---

> For AI agents: a documentation index is available at https://idratherbewriting.com/llms.txt. Markdown versions of all pages are available by appending .md to any page URL.

# DITA: Notes

> Notes are tips, notes, cautions, and other admonition statements that you provide to users. Notes can appear inside most elements.

```xml
<note type="tip">Don't fasten the bolts too tightly. First make sure all the pieces
fit well together, and then tighten them down firmly.</note>
```

There are actually quite a few options for note types: attention, danger, fastpath, important, notice, other, remember, restriction, tip, warning.

Some of the types have different icons and formatting associated with them. All of notes transform to HTML with a class corresponding with their name.

If you're adding a note inside a task list, add the note inside the `info` element.

If you want a title to preface the note, use the `fig` element:

```xml
<fig><title>Bolt Warning</title>
<note type="tip">Don't fasten the bolts too tightly.
First make sure all the pieces fit well together, and then tighten them down firmly.</note>
</fig>
```