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

Most of the 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.

Differently defined are the code snippets, which are generated using ````[language]. You can examine the Code Snippet section.

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.

Captions

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 definition, 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.

Code Snippets

To generate a code snippet you can use four backtick quotes followed by the language used in the snippet.

Note: You indentation is disregarded, so it will be rendered as placed.

Example 4: Generating a single code snippet

````JavaScript
var oWin = #find("<%= RadWindow1.ClientId %>")
````

Tabbed Code Snippets

To indicated that some code snippets should be in a tab-strip element, you can add >tabbedCode above the first one, and >end after the last one. That will trigger behind-the-scenes logic to modify the single code snippets to tabbed ones.

Example 5: Creating a tabbed code snippet

>tabbedCode

````ASP.NET
<telerik:RadButton runat="server" ID="RadButton1" OnClientClicking="OnClientClicking">
</telerik:RadButton>
````
````JavaScript
function OnClientClicking(sender,args){
	// some code to add ...
}
````	
>end

Test Meld!