Lines Matching full:markdown
1 title: Markdown in HTML Extension
3 # Markdown in HTML
7 An extension that parses Markdown inside of HTML tags.
11 By default, Markdown ignores any content within a raw HTML block-level element. With the `md-in-htm…
12 …content of a raw HTML block-level element can be parsed as Markdown by including a `markdown` att…
13 on the opening tag. The `markdown` attribute will be stripped from the output, while all other attr…
16 The `markdown` attribute can be assigned one of three values: [`"1"`](#1), [`"block"`](#block), or …
21 …ing to the HTML specification. Whereas the `"span"` and `"block"` values assigned to the `markdown`
22 attribute refer to the Markdown parser's behavior.
24 ### `markdown="1"` { #1 }
26 When the `markdown` attribute is set to `"1"`, then the parser will use the default behavior for th…
36 <div markdown="1">
37 This is a *Markdown* Paragraph.
45 <p>This is a <em>Markdown</em> Paragraph.</p>
55 <p markdown="1">
56 This is not a *Markdown* Paragraph.
64 This is not a <em>Markdown</em> Paragraph.
68 ### `markdown="block"` { #block } argument
70 When the `markdown` attribute is set to `"block"`, then the parser will force the `block` behavior …
79 <section markdown="block">
82 A *Markdown* paragraph.
95 <p>A <em>Markdown</em> paragraph.</p>
107 …recommended to use the default behavior of `markdown="1"`. Explicitly setting `markdown="block"` s…
110 ### `markdown="span"` { #span } argument
112 When the `markdown` attribute is set to `"span"`, then the parser will force the `span` behavior on…
121 <div markdown="span">
136 The following tags are always ignored, regardless of any `markdown` attribute: `canvas`, `math`, `o…
142 When nesting multiple levels of raw HTML elements, a `markdown` attribute must be defined for each …
143 element. For any block-level element which does not have a `markdown` attribute, everything inside …
144 ignored, including child elements with `markdown` attributes.
149 <article id="my-article" markdown="1">
152 A Markdown paragraph.
154 <section id="section-1" markdown="1">
161 <section id="section-2" markdown="1">
164 <p markdown="1">**Markdown** content.</p>
176 <p>A Markdown paragraph.</p>
183 <p><strong>Markdown</strong> content.</p>
188 When the value of an element's `markdown` attribute is more permissive that its parent, then the pa…
190 behavior. However, if the value of an element's `markdown` attribute is the same as, or more restri…
196 While the default behavior is for Markdown to not alter raw HTML, as this extension is parsing the …
199 <div markdown="1">
200 <p markdown="1">A Markdown paragraph with *no* closing tag.
209 <p>A Markdown paragraph with <em>no</em> closing tag.
218 `markdown` attribute was assigned to the element.
220 …ormalization, an element must not be a descendant of any block-level element which has a `markdown`
226 …crafted raw HTML is altered by Markdown. This extension should not be relied on to normalize and g…
227 …e best results, always include valid raw HTML (with both opening and closing tags) in your Markdown
235 >>> import markdown
236 >>> html = markdown.markdown(text, extensions=['md_in_html'])