Markdown++ Properties
You can specify the markdown syntax used for your paragraph and character styles when using ePublisher to generate Markdown++ output. By default, your project will try to use the most logical syntax, but with the Style Designer you can control the syntax on a per style basis.
Indentation Level
By default, ePublisher will generate all of your paragraphs as if they have no indentation. However, if you want your markdown syntax to reflect indentation as if it were originally authored in markdown, then you can use this property to control your unstructured paragraph's indentation level. Using this property has the effect of injecting light-weight structure into your original content. For example, if you have a paragraph that is designed to be a bulleted (unordered) list that appears indented from the previous paragraph, you would want to set this paragraph's Indentation Level to the value: 1.
Value | Description |
|---|---|
None | No markdown indentation will be created in the output. |
n | ePublisher will determine how many levels to create for this paragraph using the value n (1 or higher) as the preferred indentation level. Used in conjunction with paragraphs that use Unordered List, Ordered List, or Blockquote syntax.
levels than the previous level plus one. This will prevent invalid markdown structure from being generated. |
Syntax
By default, this property will set its value based on what it knows about your source content, which is not really that much, but in cases where it is very clear that the syntax should be a heading, list, or code fence paragraph, the default will generate a good match. However, in other cases you may want to set this property to None, which generates a normal paragraph. It is recommended that you always set this property explicitly rather than rely upon the default (Auto-Detect).
Value | Description |
|---|---|
Auto-Detect | Most often will set your paragraph to use no syntax (None). However, in cases where the paragraph is clearly a heading, then it will set to a Heading 1 through Heading 6 syntax. It can also detect Ordered List
value for your production work. Use the None value if your not sure what syntax to use. |
Title 1 | Highest level heading structure. |
Title 2 | Alternate heading structure for: Title 1 |
Heading 1 | Most common heading for starting topics. |
Heading 2 | Heading structure with varying level of significant from 2 |
Heading 3 | Heading structure with varying level of significant from 2 |
Heading 4 | Heading structure with varying level of significant from 2 |
Heading 5 | Heading structure with varying level of significant from 2 |
Heading 6 | Heading structure with varying level of significant from 2 |
Unordered List | Used for bulleted list paragraphs. Use in conjunction with the Indentation Level property. |
Ordered List | Used for numbered list paragraphs. Use in conjunction with the Indentation Level property. |
Blockquote | Used for paragraphs that are offset or discontinuous from the current flow of paragraphs. Use in conjunction with the Indentation Level property. |
Code Fence | Used to create a paragraph with code syntax. Useful for blocks of text that need to embed special characters and fixed width character spacing. |
None | Creates a paragraph without any syntax which most commonly represents normal or body content. Will create an empty line between consecutive paragraphs. |