Summary of HTML5 markup in AkashaEPUB Documents

In EPUB2, content was supposed to be written in XHTML, the XML variant of HTML. With the switch to EPUB3 there was an opportunity to switch to straight HTML, but they stuck with XHTML to preserve compatibility with older EPUB Reader devices. However, they did adopt HTML5 because that's the neat new hotness on the block. The HTML5 specification includes a variant, XHTML5, and that is what EPUB3 uses.

AkashaEPUB's Markdown renderer automatically generates the correct sort of HTML.

When including your own HTML tags in a document remember that with XHTML5 you must include the closing tag. We have to reform our old lazy ways of leaving off the closing tag, in other words. The <tagname/> variation doesn't work terribly well in my experience. Instead you must write tags as <tagname></tagname>.

Useful HTML5 tags

There are some useful HTML5 to consider using in your documents

<section epub:type="..."></section>

Informs web browsers or eReaders of some structure in the document.


  • epub:type=chapter: Marks a chapter, so you can have multiple chapters per content file.
  • epub:type=part:

This would be useful for something like a magazine or newspaper, where the publication contains a group of individual articles.

<aside id="..." epub:type="..."></aside>

Containing content that is outside, aside to, the normal reading flow. Such as a sidebar or footnote.

  • epub:type=sidebar:
  • epub:type=endnote:
<a href="#anchorName" epub:type="noteref">2</a>
<aside epub:type="footnote">... footnote content</aside>

Is how to represent a footnote.

<dl epub:type="glossary">
<dd>Sulphur; See <a href="#def-sulphur">Sulphur</a>.</dd>

For glossary entries.

<nav epub:type="toc"><h2>...</h2><ol>...</ol></nav>

Creates navigational links. The primary use is in the navigation document, a.k.a. table of contents page. But it can be used anywhere you want to have additional lists of links. For example, some authors like to put a small table of contents at the beginning of chapters.


Stuff for the top or bottom of a page.


Play multimedia

Read further

There's a lot more HTML5 tags available, these just scratch the surface and were chosen because of their likelihood for use in an EPUB and that they're outside the typical tags.

Media queries - responsive EPUB3 design

Not all EPUB readers can display colors, so you might do this to use a grayscale design on non-color devices.

@import url(color.css) screen and (color);
@import url(grayscale.css) screen and (not color);

Different page layouts can be chosen based on display size:

@media screen and (max-width: 720px) {
@media screen and (max-width: 1024px) {

EPUB3 supports CSS Multicolumn Layout making this possible:

article {
    column-count: 2;
    column-gap: 1em;
    /* styling of dividing line
       between columns */
    column-rule: rgb(0,0,0) dashed 1px;

Summary of HTML5 markup in AkashaEPUB Documents

( comments powered by Disqus