Callouts and Highlights - rgdevment/Tisty GitHub Wiki
Callouts, highlights, icons and checklists
Callouts
Five kinds, each with its own colour. Underneath, a callout is a quote that opens with its name in brackets — the same syntax GitHub uses, which is why they render on this page too.
[!NOTE] For what is worth knowing, with no urgency at all.
[!TIP] GitHub wants the kind alone on its first line; Tisty also takes words after it, which become the callout's first line.
[!IMPORTANT] For what cannot be passed over.
[!WARNING] For what can go wrong if you do not look.
[!CAUTION] For what has no way back.
> [!NOTE]
> For what is worth knowing, with no urgency at all.
> [!WARNING]
> For what can go wrong if you do not look.
Nearly anything fits inside a callout, not only text — lists, code, rules — and all of it reaches the PDF the same:
[!TIP] The steps of a backup by hand:
- Close Tisty
- Copy the whole folder
cp -r ~/Tisty ~/Backup
A plain quote, without a kind, is still an ordinary aside.
Highlighting
Four pens in the bar: yellow, green, blue and pink. Select words and pick the colour, or pick it first and type.
Yellow is written as ==text==; any other colour is named in braces right after the closing wall:
==yellow==
==green=={green}
==blue=={blue}
==pink=={pink}
The file also takes red, orange, amber, teal, indigo, purple, brown and gray. The rules are on The Tisty language.
Icons
An icon is looked up by what it draws: ask for «dog», «motorcycle» or «fist» and you get the one you expected. It marks a line without spending a heading on it, and it can take a colour.
::dog orange:: Rina's vaccines
Another Markdown reader shows ::dog orange:: as words; Tisty draws the icon. The names and colours are on The Tisty language.
Checklists
A list of boxes you tick. They are not Tisty tasks: they never close, they have no date and they never show up in Today. They are the steps of something you are writing.
- Bring Rina's record book
- Weigh her before the appointment
- Ask about the tick tablet
- [x] Bring Rina's record book
- [ ] Ask about the tick tablet