<div>
,<table>
, <pre>
, <p>
, etc. — must be separated from surroundingcontent by blank lines, and the start and end tags of the block shouldnot be indented with tabs or spaces. Markdown is smart enough notto add extra (unwanted) <p>
tags around HTML block-level tags.*emphasis*
inside anHTML block.<span>
, <cite>
, or <del>
— can beused anywhere in a Markdown paragraph, list item, or header. If youwant, you can even use HTML tags instead of Markdown formatting; e.g. ifyou’d prefer to use HTML <a>
or <img>
tags instead of Markdown’slink or image syntax, go right ahead.<
and &
. Left angle brackets are used to start tags; ampersands areused to denote HTML entities. If you want to use them as literalcharacters, you must escape them as entities, e.g. <
, and&
.AT&T
’. You even need toescape ampersands within URLs. Thus, if you want to link to:href
attribute. Needless to say, this is easy toforget, and is probably the single most common source of HTML validationerrors in otherwise well-marked-up web sites.&
.<
and &
in your example code needs to be escaped.)<br />
tag.<br />
break tag using Markdown, youend a line with two or more spaces, then type return.<br />
, but a simplistic“every line break is a <br />
” rule wouldn’t work for Markdown.Markdown’s email-style blockquoting and multi-paragraph list itemswork best — and look better — when you format them with hard breaks.=
’s or -
’s will work.>
characters for blockquoting. If you’refamiliar with quoting passages of text in an email message, then youknow how to create a blockquote in Markdown. It looks best if you hardwrap the text and put a >
before every line:>
before the firstline of a hard-wrapped paragraph:>
:<p>
tags in the HTML output. For example, this input:>
delimiters need to be indented:<pre>
and <code>
tags.&
) and angle brackets (<
and >
)are automatically converted into HTML entities. This makes it veryeasy to include example HTML source code using Markdown — just pasteit and indent it, and Markdown will handle the hassle of encoding theampersands and angle brackets. For example, this:<hr />
) by placing three ormore hyphens, asterisks, or underscores on a line by themselves. If youwish, you may use spaces between the hyphens or asterisks. Each of thefollowing lines will produce a horizontal rule:*
) and underscores (_
) as indicators ofemphasis. Text wrapped with one *
or _
will be wrapped with anHTML <em>
tag; double *
’s or _
’s will be wrapped with an HTML<strong>
tag. E.g., this input:*
or _
with spaces, it’ll be treated as aliteral asterisk or underscore.`
).Unlike a pre-formatted code block, a code span indicates code within anormal paragraph. For example:!
;alt
attribute text for the image;title
attribute enclosed in doubleor single quotes.<img>
tags.<em>
tag), you can usebackslashes before the asterisks, like this: