| 5 | 5 | specification is frozen. This means cross-references must be implemented |
| 6 | 6 | as an extension to the Markdown specification, leaving the door open for |
| 7 | | differing Markdown rendering libraries and applications to diverge on |
| 8 | | with respect to syntax. |
| 7 | differing Markdown rendering libraries and applications to diverge with |
| 8 | respect to syntax. |
| 9 | 9 | |
| 10 | 10 | # Syntax |
| 11 | 11 | |
| 12 | 12 | This section describes how to use captions and cross-references within |
| 13 | 13 | Markdown documents. The CommonMark standard details different ways to |
| 14 | 14 | add captions to tables and figures. While those are supported, a more |
| 15 | | consistent syntax is available. |
| 15 | consistent syntax has been implemented. |
| 16 | 16 | |
| 17 | 17 | ## Captions |
| 18 | 18 | |
| 19 | 19 | Tables, figures, and equations are captioned using the same syntax. In |
| 20 | 20 | general, a line that starts with a double colon after a blank line will |
| 21 | | result in a caption added to the item immediately proceding it. The |
| 21 | result in a caption added to the item immediately preceding it. The |
| 22 | 22 | remainder of this section provides examples. |
| 23 | 23 | |
| 24 | 24 | ### Images |
| 25 | 25 | |
| 26 | 26 | An image caption: |
| 27 | 27 | |
| 28 | 28 | ``` |
| 29 | |  |
| 29 |  |
| 30 | 30 | |
| 31 | 31 | :: Figure caption text |
| ... |
| 51 | 51 | |
| 52 | 52 | ``` |
| 53 | | $$E | mc^2$$ |
| 53 | $$E = mc^2$$ |
| 54 | 54 | |
| 55 | 55 | :: Equation caption |
| ... |
| 69 | 69 | |
| 70 | 70 | The `type-name` can be any alphanumeric value, starting with a letter. |
| 71 | | Type names user-defined categories for the item type. Labels are user-defined |
| 72 | | identifiers that must be unique per item. |
| 71 | Type names are user-defined categories for the item type. Labels are |
| 72 | user-defined identifiers that must be unique per item. |
| 73 | 73 | |
| 74 | 74 | Consider the following example: |
| 75 | 75 | |
| 76 | 76 | ``` |
| 77 | 77 | In [@fig:kitten], a cute kitten is shown. |
| 78 | 78 | |
| 79 | |  |
| 79 |  |
| 80 | 80 | |
| 81 | 81 | :: World's cutest kitten {#fig:kitten} |