Using Notices

Aug 20, 2021 · 2 min read ·

The “Notices” shortcode enables you to call out pieces of information - sidebars, warnings, tips, etc.

To create a notice on a page, you can use the notice shortcode.
You use the notice shortcode, with the first parameter being one of note, info, tip, and warning. Then add a title for your note in quotes as the second parameter. The inner body of the note can be whatever markdown you want to create.

The following shortcode syntax within a markdown doc:

{{% notice note "Note" %}}
This is a standard "note" style.
{{% /notice %}}

will render as:

Note

This is a standard “note” style.

The other three variants follow.

Info

Here is the “info” style.

Tip

Here is a “tip” variant of a notice.

Warning

Here is the “warning” flavor of a notice.

Also note that the content of a notice can contain anything you could put on a normal page - as shown below:

Complex Notices are Possible!

This is a notice that has a lot of various kinds of content in it.

Here is a bulleted list
With more than one bullet
- And even more than one level

Code blocks are fine here, too….

public void SayHello()
{
    Console.WriteLine("Hello, world!");
}

Productivity Booster!

If you’re using VS Code for your editing, copy the .vscode\clarity.code-snippets file into a .vscode root folder on your repo. This will enable you to type note then <tab> then choose with up/down arrows which flavor notice you want, then <tab> again to provide a title, then <tab> to add your content!

To use the snippet, you need to first enable quickSuggestions for Markdown (one time only):

Go to Preferences->Settings then search for quickSuggestions
Follow the link to Edit in settings.json
Toward the bottom of the file, paste in the following JSON:

"[markdown]":  {
    "editor.quickSuggestions": true
  }

Close and save the settings.