Last Updated: Oct 22, 2019
documentation for the dotCMS Content Management System

This file is intended to demonstrate the capabilities of the dotCMS markdown plugin

Markdown Basics

Markdown allows you to write using an easy-to-read, easy-to-write plain text format, which then converts to valid HTML for viewing on dotCMS. This list of examples was taken from, which has popularized markdown to the point that it has become a defacto web standard

Basic writing


Paragraphs in Markdown are just one or more lines of consecutive text followed by one or more blank lines.

On July 2, an alien mothership entered Earth's orbit and deployed several dozen saucer-shaped “destroyer” spacecraft, each 15 miles (24 km) wide.

On July 3, the Black Knights, a squadron of Marine Corps F/A-18 Hornets, participated in an assault on a destroyer near the city of Los Angeles.


You can create a heading by adding one or more # symbols before your heading text. The number of # you use will determine the size of the heading.

The largest heading (an <h1> tag)

The second largest heading (an <h2> tag)

The 6th largest heading (an <h6> tag)


You can indicate blockquotes with a >.

In the words of Abraham Lincoln:

Pardon my french

Styling text

You can make text bold or italic.

This text will be italic This text will be bold

Both bold and italic can use either a * or an _ around the text for styling. This allows you to combine both bold and italic if needed.

Everyone must attend the meeting at 5 o'clock today.


Mistaken text.


Unordered lists

You can make an unordered list by preceding list items with either a * or a -.

  • Item

  • Item

  • Item

  • Item

  • Item

  • Item

Ordered lists

You can make an ordered list by preceding list items with a number.

  1. Item 1
  2. Item 2
  3. Item 3

Nested lists

You can create nested lists by indenting list items with tabs.

  1. Item 1
    1. A corollary to the above item.
    2. Yet another point to consider.
  2. Item 2
    • A corollary that does not need to be ordered.
    • This is indented four spaces, because it's two spaces further than the item above.
    • You might want to consider making a new list.
  3. Item 3

Code formatting

Inline formats

Use single backticks (`) to format text in a special monospace format. Everything within the backticks appear as-is, with no other special formatting.

Here's an idea: why don't we take SuperiorProject and turn it into **Reasonable**Project.

Multiple lines of Code

You can use triple backticks ``` before and after text to format it as its own distinct block.

Check out this neat program I wrote:

x = 0
x = 2 + 2
what is x

You can append a class=“” element to your code block by typing the class you would like to append after the triple ticks. These classes can be parsed by third party syntax highlighers like highlight.js.

Check out this javascript program I wrote:

var _self = (typeof window !== 'undefined')
    ? window   // if in browser
    : (
        (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope)
        ? self // if in worker
        : {}   // if in node js


You can create an inline link by wrapping link text in brackets ( [ ] ), and then wrapping the link in parentheses ( ( ) ).

For example, to create a hyperlink to, with a link text that says, Visit GitHub!, you'd write this in Markdown: Visit GitHub!.

See also

Auto Linking

Links are detected automatically and linked appropriately.

Mistaken text.


You can create tables by assembling a list of words and dividing them with hyphens - (for the first row), and then separating each column with a pipe

First HeaderSecond Header
Content CellContent Cell
Content CellContent Cell

You can also include inline Markdown such as links, bold, italics, or strikethrough:

HelpDisplay the help window.
CloseCloses a window

Finally, by including colons : within the header row, you can define text to be left-aligned, right-aligned, or center-aligned:

Left-AlignedCenter AlignedRight Aligned
col 3 issome wordy text$1600
col 2 iscentered$12
zebra stripesare neat$1


Here is how images are embedded

dotCMS logo

Testing Extended

Headline with ID

Another headline with ID {#headid2}

  • List with ID

Links: Foo

© becomes ©

® becomes ®

™ becomes ™

– becomes –

— becomes —

… becomes …

« becomes «

becomes »

“Hello” becomes “Hello”

On this page


We Dig Feedback

Selected excerpt: