Skip to main content

Template Syntax Reference

Updated this week

Clara Templates support a compact placeholder syntax that controls how AI structures and formats generated notes.
​
​

Use the reference below when building or editing templates.


Supported Syntax

##{{instruction}}

General AI instruction.

  • Typically placed at the top of the template.

  • Controls tone, formatting, or style.

  • Not included in the final note output.


[placeholder]

Standard extracted content.

  • Clara attempts to populate this section if information is present.

  • If no relevant content exists, it may leave the section minimal.


[placeholder?]

Optional content.

  • Section is omitted entirely if not mentioned in the transcript.

  • Helps reduce unnecessary filler text.


[placeholder!]

Required content.

  • Section is always included.

  • Clara will generate brief content even if limited detail is provided.


["exact text"]

Verbatim output.

  • Text appears exactly as written.

  • Useful for required closing statements or disclaimers.


[placeholder | hint]

Formatting hint.

Common hints include:

  • bullets

  • numbered

  • paragraph

  • brief

Hints guide formatting style but do not appear in the final note.


Example Snippet

##{{Use professional medical terminology. Be concise and precise with injection documentation. Focus on treatment areas, units administered, and patient tolerance.}}
​
​

SUBJECTIVE

[chief complaint and reason for Botox treatment today!]

[interval history since last treatment - effectiveness, duration of prior results?]


Allowed HTML Elements

Use only the following tags inside template content:

  • <p>

  • <br>

  • <strong>

  • <b>

  • <em>

  • <i>

  • <u>

  • <ul>

  • <ol>

  • <li>

Avoid unsupported elements such as:

  • Tables

  • Images

  • Embedded media

  • Scripts or advanced styling

Unsupported tags may break formatting.


Best Practices

  • Keep section structure predictable (e.g., Subjective, Objective, Assessment, Plan).

  • Place tone/style instructions inside ##{{...}} once, near the top.

  • Use specific placeholders instead of vague prompts.

  • Use optional markers (?) generously to reduce hallucinated filler.

  • Use required markers (!) only when a section must always appear.

Well-structured templates improve consistency and reduce post-generation editing.

Did this answer your question?