Custom Styles
The Custom Style command overrides the default Style Name of a Markdown element with a user-defined Style Name. Using this feature enables a virtually limitless amount of styles for designing & publishing in ePublisher.
Syntax
The Custom Style command is created by writing style: followed by the name of the intended style.
Basics
A basic Custom Style command applied to a Paragraph.
<!--style:CustomParagraph-->
This paragraph has it's style name customized to "CustomParagraph".
Put the tag on the line above any block-level element to customize it. Make sure there are no empty lines between the tag and the block element. The tag needs to be the only thing on it's line.
<!--style:CustomHeading1-->
# This Heading has been renamed to "CustomHeading1".
For Custom Styles on inline text content, put the tag directly before the starting syntax. No space should be put between the tag and the inline syntax. A string of bold text is customized with the Style Namme CustomBold below.
This paragraph has customized <!--style:CustomBold-->**bold text**.
Mix with Other Commands
Custom Styles can be in the same comment tag with other commands. Separate them with a
; character. A Custom Style and
Custom Alias are written in the same tag below.
<!-- style:CustomStyle ; #custom-alias -->
Custom Style Command Behavior
Through the Custom Style command, it is possible to get name entries for almost any type of style into ePublisher's Style Designer. How to do so varies based on style type.
Custom Paragraph Style
Add the style tag to the line directly above a block-level element to give it a custom Paragraph Style. This applies to any block-level element, except for Tables.
<!--style:CustomParagraph-->
This is a custom paragraph called "CustomParagraph".
<!--style:CustomHeading1-->
# This is a custom paragraph called "CustomParagraph".
<!--style:UList-->
- custom list
- unordered
- called "CustomUList"
<!--styleCustomBlockquote-->
> This is a custom blockquote
>
<!--style:CustomHTML-->
<div>
<p>This is customized HTML. Named "CustomHTML".</p>
</div>
Custom Character Style
Add a style tag directly before inline syntax to create a custom Character Style. Remember, no space between the tag and the inline syntax. This applies to any inline syntax, except for Images.
This is customized <!--style:CustomBold-->**bold text**.
This is customized <!--style:CustomItalic-->*italic text*.
This is a customized <!--style:CustomLink-->[link](my_doc.md).
This is a customized <!--style:CustomHTML--><span>Inline HTML</span>.
Custom Graphic Style
Add a style tag directly before image syntax to create a custom Graphic Style. Remember, no space between the tag and the image syntax.
<!--style:CustomImage-->![alt text](my_image.png)
<!--style:CustomImage-->![alt text][link_key]
Custom Table Style
Like custom Paragraph Styles, add the tag to the line directly above Table syntax to give it a custom Table Style.
<!--style:CustomTable-->
| name | age | city |
|------|-----|---------|
| Bob | 42 | Dallas |
| Mary | 37 | El Paso |
<!--style:CustomTable-->
name | age | city
------|-----|------
Bob | 42 | Dallas
Mary | 37 | El Paso
Custom Page Style
Custom Page Styles need to be created through the
Custom Markers command. Refer to the linked section for details.
<!--markers:{"PageStyle": "CustomPage"}-->
# Topic Heading
Custom Marker Style
Custom Marker Styles need to be created through the
Custom Markers command. Refer to the linked section for details.
<!--markers:{"Keywords": "topic, heading, markers"}-->
# Topic Heading