Notes, remarks, conversations

remark

Use remark syntax to embed notes within the text area of a phrase.

Remarks may also be used to initiate a conversation between the author and an editor or reviewer.

Syntax

A remark is enclosed within a matched pair of graymark delimiters, opening with a slash-asterisk /* and closing with an asterisk-slash */.

The remark itself is everything between the graymark delimiters.

Remarks may be signed by an author, editor or reviewer using signature syntax, which is a full-stop followed by a person's name. Spaces are not allowed in a signature. The signature is optional, but when used, it must be placed at the start of the remark.

/* .signature The remark itself */
Graynote remark syntax

Graynote remarks may be embedded into the text area of any type of phrase.

Unlike terminal comments, remarks may span multiple lines.

Nested graynotes are not allowed.

Any whitespace before or after the graymark delimiters are preserved.

Graynote remark syntax is a convenient way to hide working notes, composition outlines, and other long blocks of text that are for the author's use only.

Examples

Here is what a remark looks like within the body of a manuscript.

/* .jp The use of remarks within a manuscript is a versatile way
to allow the author to keep unfinished thoughts close to where they
eventually need to be. */

Here is a remark used /* embedded? */ within a regular sentence.

Here is a remark embedded within a <<i term-mark /* italics */ >>.
Sample remark syntax

syntax > notes > remarkNotes, remarks, conversations

🔎