Comments
Hide parts of a document from rendering — drafts, notes, or temporarily-removed sections — without deleting them.
AI assisted, human approved — novem uses AI to review and keep our documentation up to date.
Available in: documents only.
Visible text.
{{/*
This whole block is commented out — prose, sections and page breaks
inside it are all ignored and never rendered.
## Even headings
{{ vis ref: /u/me/p/draft }}
*/}}
More visible text.
A comment block hides everything between its markers from the rendered document. Use it to park a draft section, leave yourself a note, or pull something out temporarily without losing it.
The opener {{/* and the closer */}} each go on their own line:
{{/*
...anything here is hidden...
*/}}
Anything between them — paragraphs, headings, {{ }} sections, page breaks,
lists — is removed before the document is parsed, so it has no effect at all on
the output (it won't even create a blank page).
An inline {{/* that shares a line with other text is not a comment — the
markers only count when alone on a line.
Comments do not nest. The first */}} closes the block; a {{/* that
appears inside a comment is just part of the hidden content.
{{/*
hidden
{{/* still hidden — not a new comment */}}
this line is visible again
Comment markers inside a fenced code block (``` or ~~~) are shown
verbatim as code — they don't start or end a comment:
```
{{/*
this is sample code, not a comment
*/}}
```
(A comment that wraps a code fence — opener before the fence, closer after — still hides the fence along with everything else, since the opener wasn't inside it.)
## Q2 results
Revenue grew 18%.
{{/*
TODO: add the segment breakdown chart once the data is final
{{ vis ref: /u/novem/p/segment_breakdown }}
*/}}
Operating margin widened to 22%.