by

Markdown List Syntax



Summary¶

Unlike block-level HTML tags, Markdown syntax processed within span-level. Markdown’s email-style blockquoting and multi-paragraph list items work best. Markdown Syntax. How the Userguide works. To make a unordered list, put an asterisk, minus, or + at the beginning. Content Markdown Syntax. You may use any of the following symbols to denote bullets for each list item.

The Sane Lists extension alters the behavior of the Markdown List syntaxto be less surprising. Lg an wf100 wi fi usb adaptor driver.

This extension is included in the standard Markdown library.

Syntax¶

Sane Lists do not allow the mixing of list types. In other words, an orderedlist will not continue when an unordered list item is encountered andvice versa. For example:

will result in the following output:

Whereas the default Markdown behavior would be to generate an unordered list.

Note that, unlike the default Markdown behavior, if a blank line is notincluded between list items, the different list type is ignored completely.This corresponds to the behavior of paragraphs. For example:

With this extension the above will result in the following output:

Sane lists also recognize the number used in ordered lists. Given the followinglist:

By default markdown will ignore the fact that the first line startedwith item number “4” and the HTML list will start with a number “1”.This extension will result in the following HTML output:

In all other ways, Sane Lists should behave as normal Markdown lists.

Usage¶

See Extensions for general extension usage. Use sane_lists as thename of the extension.

This extension does not accept any special configuration options.

A trivial example:

Basic Formatting

  • Bold: **Bold**
  • Emphasized: *Emphasized*
  • Strikethrough : ~~Strikethrough~~
  • Horizontal rules: --- (three hyphens), *** (three asterisks), or ___ (three underscores).

Headings

Markdown List Syntax

All heading levels (e.g. H1, H2, etc), are marked by # at the beginning of a line. For example, an H1 is # Heading 1 and an H2 is ## Heading 2. This continues to ###### Heading 6.

Lists In Markdown

Links

Links can be created using several methods:

  • Links can be [inline](https://markdowntohtml.com)
  • Inline links can [have a title](https://markdowntohtml.com 'Awesome Markdown Converter')
  • Also, there can be reference links that allow the URL to be placed later in the document:
    • Here is a [reference link][markdowntohtml] that links to this site.
    • References are case-insensitive (for example [this link][MarkDownToHTML] works).
    • References can also [use numbers][1].
    • Or leave it empty and use the [link text itself].
  • Also, you can use relative links [like this](./blob/master/LICENSE.txt).
  • URLs and URLs in angle brackets will automatically get turned into links: https://markdowntohtml.com or <https://markdowntohtml.com>.
URLs for reference links are somewhere later in the document like this:

Github Markdown Guide

Markdown List Syntax

Images

Images can also be inline or use a reference style, similar to links. Simply prepend an exclamation point to turn the link into an image. For example: