Documentation Archive

Developer

Markup Formatting Reference

On This Page

Block Comment

Add a block of markup using these special opening and closing comment markers.

Works with:

  • ✓ Playgrounds

  • ✓ Symbol documentation

Playground Syntax

Use a forward slash (/) followed by an asterisk (*) and then a colon (:) for the opening comment. Use an asterisk followed by a forward slash for the closing comment.

  • /*:
  •      line of text with optional markup
  •      …
  •      line of text with optional markup
  •  */

The lines in between the opening and closing comments can contain text, text and markup, or nothing. There is no limit to the number of lines.

Text on same line of the opening comment is ignored.

Example

The following markup show a numbered list of the top three coffee producers of 2014.

  1. /*:
  2.  1. Brazil
  3.  2. Vietnam
  4.  3. Colombia
  5. */
image: Art/MFR_comment_block_pg_eg_2x.png

Quick Help Syntax

Use a forward slash (/) followed by two asterisks (*) for the opening comment. Use an asterisk followed by a forward slash for the closing comment.

  • /**
  •      line of text with optional markup
  •      …
  •      line of text with optional markup
  •  */

The lines in between the opening and closing delimiters can contain text, text and markup, or nothing. There is no limit to the number of lines.

The opening comment line can contain text that will be concatenated with the contents of the line below the delimiter. This is the only case where lines are concatenated.

Example

The following markup documents the cubes and people parameters.

  1. /**
  2. - parameters:
  3.   - cubes: The cubes available for allocation
  4.   - people: The people that require cubes
  5. */
image: Art/MFR_symbol_section_parameters_2x.png