Blockquotes
Blockquotes are unique block-level elements that can contain other block-level elements. They have a diverse set of usages due to this, such as capturing a sequence of conversation, or being a container for an important presentation of concepts.
Syntax
Blockquotes are created by starting a line with the > character. A space between text content and the > character is optional, but recommended. Any Markdown or Markdown++ convention is acceptable as text content inside of Blockquotes.
Basics
A basic Blockquote containing a single Paragraph
> A paragraph inside a blockquote.
Markdown In Blockquotes
Other Markdown elements, like headings and lists, can be used inside Blockquotes. Use the same spacing and indentation rules as usual when inside Blockquotes.
> ### How to Publish Content with ePublisher
>
> Here's some steps to publish your content with ePublisher.
>
> 1. Open ePublisher
> 2. Add source documents
> 3. Select Format
> 4. Click **Generate All**
Nested Blockquotes
Other Blockquotes can also be nested inside of Blockquotes, and so on.
> First level blockquote
>
> > Second level nested blockquote.
> >
> > > Third level nested blockquote.
> > >
Markdown++
A custom Paragraph Style can be given to a Blockquote using a Markdown++ style tag on the line directly above the Blockquote.
<!--style:CustomBlockquote-->
> A customized blockquote, style name "CustomBlockquote"
Customizing Nested Blockquotes
Nested Blockquotes can be customized as well.
> A default blockquote, style name "Blockquote"
>
> <!--style:CustomBlockquote-->
> > A customized blockquote, style name "CustomBlockquote"
> >
Default Until Customized
Nested Blockquotes are treated as standalone; they will not inherit the outermost stylename if customized.
<!--style:CustomBlockquote-->
> A customized blockquote, style name "CustomBlockquote"
>
> > A default blockquote, style name "Blockquote"
> >
Add a style tag to each blockquote individually for consistency with custom styles.
<!--style:CustomBlockquote-->
> A customized blockquote, style name "CustomBlockquote"
>
> <!--style:CustomBlockquote-->
> > A customized blockquote, style name "CustomBlockquote"
> >
Markdown in Blockquotes
The tagging convention can be used for other Markdown elements inside Blockquotes. These style names will inherit the Blockquote's style name as a prefix. See
Nested Styles for more info.
> <!--style:CustomParagraph-->
> A customized paragraph, style name "Blockquote CustomParagraph"
>
> <!--style:CustomList-->
> - an unordered list
> - customized
> - style name "Blockquote CustomList"
>
ePublisher Style Information
Style Behavior
Blockquotes are considered containers; they contain other block-level elements, like Paragraphs, Lists, and Tables. Because of this, ePublisher creates a number of different styles when it detects blockquotes in source documents.
Blockquote Style
The Blockquote Style is the first style that ePublisher adds to the Style Designer when a blockquote is detected in a source document. The default name is Blockquote, but could also be a custom name if the style tag syntax is used on the blockquote.
This style applies to the container area surrounding the blockquote's content. It's style rules can also apply to nested content, if the same rule isn't already applied on the nested style.
Customizing the Blockquote Style
By adding a Markdown++ custom style tag, the Blockquote Style name can be changed. The example below changes the Blockquote Style name to CustomBlockquote:
<!--style:CustomBlockquote-->
> This is a custom named blockquote.
>
Nested Styles
Nested content inside of Blockquotes also get a new style name. To determine the Nested Style's name, take the Blockquote Style and add the style name of the nested content to the end, separated by a space.
The example below populates the Style Designer with 3 Paragraph Styles: Blockquote (the Blockquote Style), Blockquote Heading 1, and Blockquote Paragraph when scanned into ePublisher.
> # Heading 1 element inside a blockquote
>
> This is a Paragraph element inside of a blockquote.
>
Customizing Nested Styles
By adding a Markdown++ custom style tag, the Nested Style name can be changed. The example below changes the Nested Style name to Blockquote CustomParagraph:
> <!--style:CustomParagraph-->
> This is a custom paragraph.
>
Custom Style Names can be used on both the blockquote and nested content simultaneously. This example creates the style names CustomBQ, and CustomBQ CustomParagraph:
<!--style:CustomBQ-->
> <!--style:CustomParagraph-->
> This is a custom paragraph inside a blockquote.
>
Default Style Properties
Style Type: Paragraph
Style Name: Blockquote
Property | Value |
|---|
background color | #efefef |
border left style | solid |
border left color | #DFE2E5 |
border left width | 3pt |
padding top | 12pt |
padding right | 12pt |
padding bottom | 12pt |
padding left | 12pt |
If a custom style name is assigned to a Blockquote, that style name will still inherit all of the listed default style information.