Markdown Support

What is Markdown?

Markdown is a markup language used to add formatting elements to plaintext text documents. It is written as a regular text along with a few non-alphabetic characters such as a number sign or an asterisk # or *.

Markdown support in Case Management

Case Management supports some of the basic Markdown and HTML syntax that you can use in the Summary and Comments section or in your own text files. The syntaxes are described below with examples and output that is rendered.

Headings

To create a heading, add a number sign (#) in front of a word or phrase. The number of number signs you use should correspond to the heading level. For example:

• To create a Markdown heading level three, use three number signs ### Heading 3.

• To create an HTML heading level three, use heading tag <h3>Heading 3</h3>

# Heading level 1 ## Heading level 2 ### Heading level 3 #### Heading level 4 ##### Heading level 5 ###### Heading level 6

<h1>Heading level 1</h1> <h2>Heading level 2</h2> <h3>Heading level 3</h3> <h4>Heading level 4</h4> <h5>Heading level 5</h5> <h6>Heading level 6</h6>

Open

Alternative Markdown Syntax

Alternatively, on the line below the text, add any number of == characters for heading level 1 or -- characters for heading level 2.

Heading level 1 =============== Heading level 2 ---------------

Open

Links

To create a link, enclose the text in brackets (example, [Google Search Engine]) and then follow it immediately with the URL in parentheses (example, (https://www.google.com/)).

Links: Reference-style

Reference-style links are a special kind of link that makes URLs easier to display and read in Markdown. These links are constructed in two parts:

1. The part you keep in line with your text.

2. The part you store somewhere else in the file to keep the text easy to read.

The first part of a reference-style link is formatted with two sets of brackets.

1. The first set of brackets surrounds the text that should appear linked.

2. The second set of brackets displays a label used to point to the link you’re storing elsewhere in your document.

Emphasis

You can add emphasis using * or _ wrapped words and phrases as bold and italic emphasis. Refer to the examples below.

Bold

To bold text, add two asterisks or underscores before and after a word or phrase.

Italics

To italicize text, add one asterisk or underscore before and after a word or phrase.

Bold and Italic

To emphasize text with bold and italics at the same time, add three asterisks or underscores before and after a word or phrase.

Strikethrough

To strikethrough text, add two tildes (~) before and after a word or phrase.

Line Separators

To add a line separator, you can use a line with three or more dashes with an extra blank line before and after or three or more * characters.

Lists

You can organize items into ordered and unordered lists.

Ordered Lists

To create an ordered list, add line items with numbers followed by periods. The numbers don’t have to be in numerical order, but the list should start with the number one.

Ordered Lists: Indentation

To indent the sub-items in an ordered list, use at least two or four spaces and add the sub-item numbering such as a, i, or the number itself.

Unordered Lists

To create an unordered list, add dashes (-), asterisks (*), or plus signs (+) in front of line items. Indent one or more items to create a nested list.

Unordered Lists: Indentation

Blockquotes

To create a blockquote, add a greater-than angle bracket >.

Blockquotes: Nested

To create a nested blockquote, use two greater-than angle bracket >

Blockquotes with Other Elements

You can include other elements within a blockquote.

Code

To create a code format text such as a command or a code snippet, wrap the text with backticks ()`.

Code: Disable Automatic URL Linking

You can use code definition to prevent URLs from being turned into links automatically.

Code Blocks

To create code blocks, indent every line by at least four spaces or a tab.

Code Blocks: Fenced Code Blocks

To create fenced code blocks, use three backticks (```) on the lines before and after the code block.

Images

To add an image, add an exclamation mark (!), followed by alt text in brackets, and the path or URL to the image asset in parentheses.

The title appears when you mouseover on the image. The alt text shows when the image fails to load. In the example below, the alt text/title text is "Devo".

Custom Examples

The following are some custom HTML examples that may be useful in more advanced cases.

Definition Lists via HTML

A definition list is a list of terms and corresponding definitions.

Text Color

You can define colored text using HTML.

HTML Table

HTML Table: Basic Formatting

You can format a simple HTML table.

HTML Table: Advanced Formatting

You can format a robust version of the table with some of the enhancements, such as:

• Specific widths for each column and for the table as a whole

• Set the first row as the header row

• Alternating background color for standard text

• Customized background color by severity

• Specific cell padding and margin