From 8b314304f2a70c0f6c257d539270fc387ad2f8b4 Mon Sep 17 00:00:00 2001
From: Robin Ward Markdown is intended to be as easy-to-read and easy-to-write as is feasible.
-Overview
+Overview
-Philosophy
+Philosophy
Markdown's syntax is intended for one purpose: to be used as a format for writing for the web.
@@ -115,7 +115,7 @@ link or image syntax, go right ahead.Unlike block-level HTML tags, Markdown syntax is processed within span-level tags.
-In HTML, there are two characters that demand special treatment: <
and &
. Left angle brackets are used to start tags; ampersands are
@@ -179,9 +179,9 @@ and &
in your example code needs to be escaped.)
A paragraph is simply one or more consecutive lines of text, separated by one or more blank lines. (A blank line is any line that looks like a @@ -202,7 +202,7 @@ end a line with two or more spaces, then type return.
Markdown's email-style blockquoting and multi-paragraph list items work best -- and look better -- when you format them with hard breaks. -Markdown supports two styles of headers, Setext and atx.
@@ -241,7 +241,7 @@ determines the header level.) : ### This is an H3 ###### -Markdown uses email-style >
characters for blockquoting. If you're
familiar with quoting passages of text in an email message, then you
@@ -296,7 +296,7 @@ and code blocks:
Markdown supports ordered (numbered) and unordered (bulleted) lists.
@@ -472,7 +472,7 @@ line. To avoid this, you can backslash-escape the period:1986\. What a great season.
-Pre-formatted code blocks are used for writing about programming or markup source code. Rather than forming normal paragraphs, the lines @@ -541,7 +541,7 @@ ampersands and angle brackets. For example, this:
asterisks are just literal asterisks within a code block. This means it's also easy to use Markdown to write about Markdown's own syntax. -You can produce a horizontal rule tag (<hr />
) by placing three or
more hyphens, asterisks, or underscores on a line by themselves. If you
@@ -563,9 +563,9 @@ _ _ _
Markdown supports two style of links: inline and reference.
@@ -727,7 +727,7 @@ allowing you to move the markup-related metadata out of the paragraph, you can add links without interrupting the narrative flow of your prose. -Markdown treats asterisks (*
) and underscores (_
) as indicators of
emphasis. Text wrapped with one *
or _
will be wrapped with an
@@ -772,7 +772,7 @@ escape it:
\*this text is surrounded by literal asterisks\*
-To indicate a span of code, wrap it with backtick quotes (`
).
Unlike a pre-formatted code block, a code span indicates code within a
@@ -836,7 +836,7 @@ tags. Markdown will turn this:
Admittedly, it's fairly difficult to devise a "natural" syntax for placing images into a plain text document format.
@@ -879,9 +879,9 @@ use regular HTML<img>
tags.
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:
@@ -916,7 +916,7 @@ most, address-harvesting bots, but it definitely won't fool all of them. It's better than nothing, but an address published in this way will probably eventually start receiving spam.) -Markdown allows you to use backslash escapes to generate literal characters which would otherwise have special meaning in Markdown's