medicaltext.org Cheat Sheet
Tag | Example(s) | Details |
[text] | [text default="type here"] [text name="variable_1" memo="sample" default="type here" size=100] | Simple text box. Parameters: name, memo, default, size |
[textarea] | [textarea name="variable_1" memo="sample" default="type here"] [textarea name=”variable_2” memo=”two lines” default=”line1/nline2”] [textarea name="variable_3" memo="fillable" fillable="true" default="line1\nline2\n***line3***"] [textarea name=”variable_4”]text[/textarea]] | Larger area for free text. Parameters: name, memo, cols, rows, default, fillable, sortable For multiple lines, use the 2 part version - [textarea] & [/textarea]. For ‘fillable’ feature, use pairs of ‘***’ |
[date] | [date name="variable_1"] [date memo="enter date" default="today"] [date default="timestamp"] | Date field with calendar. Parameters: name, memo, default |
[radio] | [radio name="variable_1" value="this|that"] | Field where only one option may be chosen. Parameters: name, memo, value |
[checkbox] | [checkbox value="option A|option B|option C"] | Field where multiple options may be chosen. Parameters: name, memo, value |
[checklist] | [checklist value="option A|option B|option C"] | Field where multiple options may be chosen. Output has all options with [+] or [-] Parameters: name, memo, value |
[select] | [select value="choice A|choice B|choice C"] [select value="A=1|B=2|C=3" memo="choose one"] | Field where only one option may be chosen. Parameters: name, memo, value |
[comment] | [comment memo="comment 2" memo_color="lightgreen" memo_size="small" memo_style="italic"] | Text only displays in form, not in output. Parameters: memo, memo_color, memo_size, memo_style |
[link] | [link url="https://www.soapnote.org" memo="SOAPnote Home"] | External or internal (see [mark]) links. Parameters: url, mark, memo |
[mark] | [link memo="go to the mark" mark="target"] skip [mark name="target"] | This is the target for an internal link. Parameter: name |
[organization] [address_line_1] [address_line_2] [city] [state] [postal_code] [phone] [fax] [website] [email] | Please call [phone] or email [email]. | These are items saved in a user’s profile that are pulled into the output. Parameters: none |
[blurb_1] [blurb_2] [blurb_3] | [blurb_1] the night before your visit. [blurb_2] or park in the red lot. | Three extra items which are also saved in a user’s profile. Parameters: none |
[var] | Used to recall a variable in the output. Parameter: name Variable names can’t contain spaces. | [text default="biz" name="variable_1"] [var name="variable_1"] Doesn’t work with [calc], need to use the actual variable in [calc]. |
[conditional] | [radio name="variable_1" value="A|B|C"] [conditional field="variable_1" condition="(variable_1).is(‘B’)|| (variable_1).is('C')"]Question: [text name="variable_2"][/conditional] | Used to show or hide elements based on conditions. Parameter: field, condition Nested conditional statements supported as of 1/7/2023. |
[calc] | [text name="variable_1"] <-- A [text name="variable_2"] <-- B A + B --> [calc value="score1=(variable_1)+(variable_2)" memo="just added"] A + B --> [calc value="score2=(variable_1)+(variable_2);score2>1000?’more than 1000':score2>100?'more than 100’:’100 or less'" memo="interpreted"] | Make calculations from other tags, such as [text], [radio], and [select] Parameters: value, memo, show |
[shorthand] | [shorthand name="%sample" value="This is the text that will be repeated."] [textarea name="variable_3"] | Used with [textarea] to insert frequently used text snippets. In the example, if the user types %sample in the text area, then ‘This is the text…’ will replace that text. Parameters: name, value |
[frontload] | [frontload soapnote="shorthand/shorthand-base"] | Brings in the contents of another SOAPnote into the current one. The example imports https://www.soapnote.org/shorthand/shorthand-base into the current SOAPnote Parameter: soapnote |
[remark] | [remark]Not seen in the form[/remark] | Text only displays in the markup, not in the active form or output. |
An error with a parameter is usually the culprit breaking a form. Parameter ‘name’ can be letters, underscores, and numbers. It must not have a space and cannot be only a number. Parameter ‘show’ (used with [calc]) can be true or false (no quotes). Parameters with numbers (size (used with [text]), cols and rows used with [textarea]) also have no quotes. A lot more detail at www.medicaltext.org Version 9 - January 18, 2025