Lines Matching refs:Markdown
8 Markdown is intended to be as easy-to-read and easy-to-write as is feasible.
10 Readability, however, is emphasized above all else. A Markdown-formatted
13 Markdown's syntax has been influenced by several existing text-to-HTML
16 inspiration for Markdown's syntax is the format of plain text email.
25 To this end, Markdown's syntax is comprised entirely of punctuation
28 look like \*emphasis\*. Markdown lists look like, well, lists. Even
36 Markdown's syntax is intended for one purpose: to be used as a
39 Markdown is not a replacement for HTML, or even close to it. Its
43 insert. The idea for Markdown is to make it easy to read, write, and
44 edit prose. HTML is a *publishing* format; Markdown is a *writing*
45 format. Thus, Markdown's formatting syntax only addresses issues that
48 For any markup that is not covered by Markdown's syntax, you simply
50 indicate that you're switching from Markdown to HTML; you just use
56 not be indented with tabs or spaces. Markdown is smart enough not
59 For example, to add an HTML table to a Markdown article:
71 Note that Markdown formatting syntax is not processed within block-level
72 HTML tags. E.g., you can't use Markdown-style `*emphasis*` inside an
76 used anywhere in a Markdown paragraph, list item, or header. If you
77 want, you can even use HTML tags instead of Markdown formatting; e.g. if
78 you'd prefer to use HTML `<a>` or `<img>` tags instead of Markdown's
81 Unlike block-level HTML tags, Markdown syntax *is* processed within
107 Markdown allows you to use these characters naturally, taking care of
116 and Markdown will leave it alone. But if you write:
120 Markdown will translate it to:
124 Similarly, because Markdown supports [inline HTML](#html), if you use
125 angle brackets as delimiters for HTML tags, Markdown will treat them as
130 Markdown will translate it to:
134 However, inside Markdown code spans and blocks, angle brackets and
136 Markdown to write about HTML code. (As opposed to raw HTML, which is a
155 that Markdown supports "hard-wrapped" text paragraphs. This differs
160 When you *do* want to insert a `<br />` break tag using Markdown, you
164 "every line break is a `<br />`" rule wouldn't work for Markdown.
165 Markdown's email-style [blockquoting][bq] and multi-paragraph [list items][l]
175 Markdown supports two styles of headers, [Setext] [1] and [atx] [2].
212 Markdown uses email-style `>` characters for blockquoting. If you're
214 know how to create a blockquote in Markdown. It looks best if you hard
224 Markdown allows you to be lazy and only put the `>` before the first
243 Blockquotes can contain other Markdown elements, including headers, lists,
262 Markdown supports ordered (numbered) and unordered (bulleted) lists.
290 list have no effect on the HTML output Markdown produces. The HTML
291 Markdown produces from the above list is:
299 If you instead wrote the list in Markdown like this:
312 you can use ordinal numbers in your ordered Markdown lists, so that
317 list with the number 1. At some point in the future, Markdown may support
340 If list items are separated by blank lines, Markdown will wrap the
381 paragraphs, but here again, Markdown will allow you to be
424 of a code block are interpreted literally. Markdown wraps a code block
427 To produce a code block in Markdown, simply indent every line of the
434 Markdown will generate:
464 easy to include example HTML source code using Markdown -- just paste
465 it and indent it, and Markdown will handle the hassle of encoding the
479 Regular Markdown syntax is not processed within code blocks. E.g.,
481 it's also easy to use Markdown to write about Markdown's own syntax.
511 Markdown supports two style of links: *inline* and *reference*.
571 Link definitions are only used for creating links during Markdown
601 Link definitions can be placed anywhere in your Markdown document. I
632 Markdown's inline link style:
646 With Markdown's reference-style links, a source document much more
655 Markdown treats asterisks (`*`) and underscores (`_`) as indicators of
733 tags. Markdown will turn this:
757 Markdown uses an image syntax that is intended to resemble the syntax
784 As of this writing, Markdown has no syntax for specifying the
796 Markdown supports a shortcut style for creating "automatic" links for URLs and email addresses: sim…
800 Markdown will turn this into:
805 Markdown will also perform a bit of randomized decimal and hex
807 spambots. For example, Markdown will turn this:
829 Markdown allows you to use backslash escapes to generate literal
830 characters which would otherwise have special meaning in Markdown's
837 Markdown provides backslash escapes for the following characters: