Lines Matching full:markdown
34 <p>Markdown is intended to be as easy-to-read and easy-to-write as is feasible.</p>
35 <p>Readability, however, is emphasized above all else. A Markdown-formatted
38 Markdown's syntax has been influenced by several existing text-to-HTML
41 inspiration for Markdown's syntax is the format of plain text email.</p>
42 <p>To this end, Markdown's syntax is comprised entirely of punctuation
45 look like *emphasis*. Markdown lists look like, well, lists. Even
49 <p>Markdown's syntax is intended for one purpose: to be used as a
51 <p>Markdown is not a replacement for HTML, or even close to it. Its
55 insert. The idea for Markdown is to make it easy to read, write, and
56 edit prose. HTML is a <em>publishing</em> format; Markdown is a <em>writing</em>
57 format. Thus, Markdown's formatting syntax only addresses issues that
59 <p>For any markup that is not covered by Markdown's syntax, you simply
61 indicate that you're switching from Markdown to HTML; you just use
66 not be indented with tabs or spaces. Markdown is smart enough not
68 <p>For example, to add an HTML table to a Markdown article:</p>
79 <p>Note that Markdown formatting syntax is not processed within block-level
80 HTML tags. E.g., you can't use Markdown-style <code>*emphasis*</code> inside an
83 used anywhere in a Markdown paragraph, list item, or header. If you
84 want, you can even use HTML tags instead of Markdown formatting; e.g. if
85 you'd prefer to use HTML <code><a></code> or <code><img></code> tags instead of Markdown's
87 <p>Unlike block-level HTML tags, Markdown syntax <em>is</em> processed within
106 <p>Markdown allows you to use these characters naturally, taking care of
113 <p>and Markdown will leave it alone. But if you write:</p>
116 <p>Markdown will translate it to:</p>
119 <p>Similarly, because Markdown supports <a href="#html">inline HTML</a>, if you use
120 angle brackets as delimiters for HTML tags, Markdown will treat them as
124 <p>Markdown will translate it to:</p>
127 <p>However, inside Markdown code spans and blocks, angle brackets and
129 Markdown to write about HTML code. (As opposed to raw HTML, which is a
140 that Markdown supports "hard-wrapped" text paragraphs. This differs
144 <p>When you <em>do</em> want to insert a <code><br /></code> break tag using Markdown, you
147 "every line break is a <code><br /></code>" rule wouldn't work for Markdown.
148 Markdown's email-style <a href="#blockquote">blockquoting</a> and multi-paragraph <a href="#list">list items</a>
151 <p>Markdown supports two styles of headers, <a href="http://docutils.sourceforge.net/mirror/setext.html">Setext</a> and <a href="http://www.aaronsw.com/2002/atx/">atx</a>.</p>
181 <p>Markdown uses email-style <code>></code> characters for blockquoting. If you're
183 know how to create a blockquote in Markdown. It looks best if you hard
192 <p>Markdown allows you to be lazy and only put the <code>></code> before the first
209 <p>Blockquotes can contain other Markdown elements, including headers, lists,
224 <p>Markdown supports ordered (numbered) and unordered (bulleted) lists.</p>
247 list have no effect on the HTML output Markdown produces. The HTML
248 Markdown produces from the above list is:</p>
255 <p>If you instead wrote the list in Markdown like this:</p>
266 you can use ordinal numbers in your ordered Markdown lists, so that
270 list with the number 1. At some point in the future, Markdown may support
289 <p>If list items are separated by blank lines, Markdown will wrap the
325 paragraphs, but here again, Markdown will allow you to be
359 of a code block are interpreted literally. Markdown wraps a code block
361 <p>To produce a code block in Markdown, simply indent every line of the
367 <p>Markdown will generate:</p>
393 easy to include example HTML source code using Markdown -- just paste
394 it and indent it, and Markdown will handle the hassle of encoding the
406 <p>Regular Markdown syntax is not processed within code blocks. E.g.,
408 it's also easy to use Markdown to write about Markdown's own syntax.</p>
429 <p>Markdown supports two style of links: <em>inline</em> and <em>reference</em>.</p>
479 <p>Link definitions are only used for creating links during Markdown
502 <p>Link definitions can be placed anywhere in your Markdown document. I
529 Markdown's inline link style:</p>
541 <p>With Markdown's reference-style links, a source document much more
547 <p>Markdown treats asterisks (<code>*</code>) and underscores (<code>_</code>) as indicators of
610 tags. Markdown will turn this:</p>
626 <p>Markdown uses an image syntax that is intended to resemble the syntax
649 <p>As of this writing, Markdown has no syntax for specifying the
655 <p>Markdown supports a shortcut style for creating "automatic" links for URLs and email addresses: simply surround the URL or email address with angle brackets. What this means is that if you want to show the actual text of a URL or email address, and also have it be a clickable link, you can do this:</p>
658 <p>Markdown will turn this into:</p>
662 Markdown will also perform a bit of randomized decimal and hex
664 spambots. For example, Markdown will turn this:</p>
679 <p>Markdown allows you to use backslash escapes to generate literal
680 characters which would otherwise have special meaning in Markdown's
686 <p>Markdown provides backslash escapes for the following characters:</p>
