Markdown Syntax

Markdown Syntax

Basics

The content files for the Telerik UI for ASP.NET AJAX documentation are written in Markdown. Exact syntax rules and examples for how to use Markdown are available here—daringfireball.net/projects/markdown/.

Custom Syntax

All custom elements are based on the blockquote syntax in Markdown. Therefore, the >[name] pattern is used for them.

Important: Always use camelCase for the [name] in the custom syntax.

Alerts

Alerts are used to notify the reader for something important. There are 5 types of different alerts:

• Tip
• Important
• Caution
• Warning
• Note

The type of the alert corresponds to its name. For example, >tip will create an alert of type Tip, >warning will be of type Warning.

Example 1: Alert with multiple paragraphs.

>caution This is an alert of type caution,
here the first paragraph stops. 
>
End here begins the second one.

Example 2: Alert with a paragraphs and a list.

>important This is the first paragraph.
>
* list item 1
* list item 2
>
And a second paragraph.

Caption

Captions are used as titles for tables, images, single code snippets and tabbed code snippets. To create them you can use >caption and write a line of text.

Note: Captions support only one line of text.

Important: By defintion, they should be put above the element that they describe.

Example 3: Caption syntax

>caption This should the description of an image, table or code example.