@@ -3312,45 +3312,6 @@ For the most part this should give the same output as `raw_html`,
3312but it makes it easier to write pandoc filters to manipulate groups
3312but it makes it easier to write pandoc filters to manipulate groups
3313of inlines.
3313of inlines.
3315−#### Extension: `fenced_divs` ####
3317−Allow special fenced syntax for native `Div` blocks. A Div
3318−starts with a fence containing at least three consecutive
3319−colons plus some attributes. The attributes may optionally
3320−be followed by another string of consecutive colons.
3321−The attribute syntax is exactly as in fenced code blocks (see
3322−[Extension: `fenced_code_attributes`]). As with fenced
3323−code blocks, one can use either attributes in curly braces
3324−or a single unbraced word, which will be treated as a class
3325−name. The Div ends with another line containing a string of at
3326−least three consecutive colons. The fenced Div should be
3327−separated by blank lines from preceding and following blocks.
3331− ::::: {#special .sidebar}
3332− Here is a paragraph.
3337−Fenced divs can be nested. Opening fences are distinguished
3338−because they *must* have attributes:
3344− This is a warning within a warning.
3348−Fences without attributes are always closing fences. Unlike
3349−with fenced code blocks, the number of colons in the closing
3350−fence need not match the number in the opening fence. However,
3351−it can be helpful for visual clarity to use fences of different
3352−lengths to distinguish nested divs from their parents.
3354#### Extension: `raw_tex` ####
3315#### Extension: `raw_tex` ####
3356In addition to raw HTML, pandoc allows raw LaTeX, TeX, and ConTeXt to be
3317In addition to raw HTML, pandoc allows raw LaTeX, TeX, and ConTeXt to be
@@ -3612,13 +3573,59 @@ For example:
3612 is to look at the image resolution and the dpi metadata embedded in
3573 is to look at the image resolution and the dpi metadata embedded in
3613 the image file.
3574 the image file.
3615−Spans
3576+Divs and Spans
3616−-----
3577+--------------
3579+Using the `native_divs` and `native_spans` extensions
3580+(see [above][Extension: `native_divs`]), HTML syntax can
3581+be used as part of markdown to create native `Div` and `Span`
3582+elements in the pandoc AST (as opposed to raw HTML).
3583+However, there is also nicer syntax available:
3585+#### Extension: `fenced_divs` ####
3587+Allow special fenced syntax for native `Div` blocks. A Div
3588+starts with a fence containing at least three consecutive
3589+colons plus some attributes. The attributes may optionally
3590+be followed by another string of consecutive colons.
3591+The attribute syntax is exactly as in fenced code blocks (see
3592+[Extension: `fenced_code_attributes`]). As with fenced
3593+code blocks, one can use either attributes in curly braces
3594+or a single unbraced word, which will be treated as a class
3595+name. The Div ends with another line containing a string of at
3596+least three consecutive colons. The fenced Div should be
3597+separated by blank lines from preceding and following blocks.
3601+ ::::: {#special .sidebar}
3602+ Here is a paragraph.
3607+Fenced divs can be nested. Opening fences are distinguished
3608+because they *must* have attributes:
3614+ This is a warning within a warning.
3618+Fences without attributes are always closing fences. Unlike
3619+with fenced code blocks, the number of colons in the closing
3620+fence need not match the number in the opening fence. However,
3621+it can be helpful for visual clarity to use fences of different
3622+lengths to distinguish nested divs from their parents.
3618#### Extension: `bracketed_spans` ####
3625#### Extension: `bracketed_spans` ####
3620A bracketed sequence of inlines, as one would use to begin
3627A bracketed sequence of inlines, as one would use to begin
3621−a link, will be treated as a span with attributes if it is
3628+a link, will be treated as a `Span` with attributes if it is
3622followed immediately by attributes:
3629followed immediately by attributes:
3624 [This is *some text*]{.class key="val"}
3631 [This is *some text*]{.class key="val"}