Test Topic

An exhibit of Markdown

This note demonstrates some of what Markdown is capable of doing.

Basic formatting

Paragraphs can be written like so. A paragraph is the basic block of Markdown. A paragraph is what text will turn into when there is no reason it should become anything else.

Paragraphs must be separated by a blank line. Basic formatting of italics and bold is supported. This can be nested like so.

Lists

Ordered list

1. Item 1
2. A second item
3. Number 3
4. Ⅳ

Note: the fourth item uses the Unicode character for Roman numeral four.

Unordered list

• An item
• Another item
• Yet another item

• And there’s more…

• Parker
• Sami

Paragraph modifiers

Code block

Code blocks are very useful for developers and other people who look at code or other things that are written in plain text. As you can see, it uses a fixed-width font.

You can also make inline code to add code into other things.

Quote

Here is a quote. What this is should be self explanatory. Quotes are automatically indented when they are used.

Headings

There are six levels of headings. They correspond with the six levels of HTML headings. You’ve probably noticed them already in the page. Each level down uses one more hash character.

Headings can also contain formatting

Here is a 4th Level Heading

There are six levels of headings. They correspond with the six levels of HTML headings. You’ve probably noticed them already in the page. Each level down uses one more hash character.

Here is a 5th Level Heading

There are six levels of headings. They correspond with the six levels of HTML headings. You’ve probably noticed them already in the page. Each level down uses one more hash character.

And Another 5th Level Heading

There are six levels of headings. They correspond with the six levels of HTML headings.

It has a 6th Level Heading

You’ve probably noticed them already in the page.

It has a second 6th Level Heading

Each level down uses one more hash character.

Back up to 4th Level

There are six levels of headings. They correspond with the six levels of HTML headings. You’ve probably noticed them already in the page. Each level down uses one more hash character.

They can even contain inline code

Of course, demonstrating what headings look like messes up the structure of the page.

I don’t recommend using more than three or four levels of headings here, because, when you’re smallest heading isn’t too small, and you’re largest heading isn’t too big, and you want each size up to look noticeably larger and more important, there there are only so many sizes that you can use.

URLs

URLs can be made in a handful of ways:

• A named link to MarkItDown. The easiest way to do these is to select what you want to make a link and hit Ctrl+L.
• Another named link to MarkItDown
• Sometimes you just want a URL like http://www.markitdown.net/.

Horizontal rule

A horizontal rule is a line that goes across the middle of the page.

It’s sometimes handy for breaking things up.

Images

Markdown can also contain images.

Above is an example of an image.

Markdown Variations

Discount (GFM)

GitHub Flavored Markdown, or [GFM](abbr:GitHub Flavored Markdown), adds several extensions.

Source: https://help.github.com/articles/github-flavored-markdown/

Pseudo-protocols for [] links

[text](abbr:description)
The label will be wrapped by <abbr title=" description "> … </abbr>
Test: abbr

[text](class:name)
The label will be wrapped by <span class=" name "> … </span>
Test: Wrapped in span with text-danger class.

[text](id:name)
The label will be wrapped by <a id=" name "> … </a>
Test: Wrapped in a with testingThis id.

[text](raw:text)
Text will be written verbatim to the output.
Test: Raw text output

More Examples To Come…

…

MultiMarkdown & Markdown Extra

• Markdown Extra
  — definition lists, footnotes, abbreviations,

Custom & NRSC Extensions

These are custom extensions developed for the use of NRSC Digital:

YouTube

Embeds a YouTube video:

[youtube url="https://www.youtube.com/watch?v=xfr64zoBTAQ"]

Output:

[youtube url="https://www.youtube.com/watch?v=xfr64zoBTAQ"]

Vine

[vine url="https://vine.co/v/iX7wOjx3Oa7"]

Twitter

Embeds a tweet:

[tweet src="https://twitter.com/BlakeWaggoner/status/674680153453289472"]

Output:

[tweet src="https://twitter.com/BlakeWaggoner/status/674680153453289472"]

Future embed standard

Not implemented. Do not use!

Designed to be used broadly for embeddable content:

@[twitter](https://twitter.com/BlakeWaggoner/status/674680153453289472)

Output:

@twitter

Edge Cases

Miscellaneous issues that have come up.

_________ Lines

A blank line can be created by escaping each _ (underscore) with a (backslash).

For example, this markdown

Fill in the blank: Russ Feingold lives in California, but he's running for Senate in ___________.

will produce

Fill in the blank: Russ Feingold lives in California, but he’s running for Senate in ___________.

Finally

There’s actually a lot more to Markdown than this. See the official introduction and syntax for more information. However, be aware that this is not using the official implementation, and this might work subtly differently in some of the little things.