📖 Efficient EPUB Editing with Calibre - Productivity Tips and Compatibility Notes

calibre tool

A practical guide to editing EPUB eBooks in Calibre, covering its main features, custom code snippets, keyboard shortcuts, Apple Books compatibility, and best practices for efficient eBook development.

Why Choose Calibre for EPUB Editing?

Calibre is not only a free and open-source eBook manager, but also a powerful EPUB editor suitable for both beginners and professionals. Whether you need to batch convert formats, fine-tune book structure, or ensure compatibility across devices, Calibre provides a one-stop solution. Typical scenarios include personal library management, academic publishing, and preparing eBooks for commercial distribution.

Overview of Calibre Features

Calibre covers the entire workflow of eBook management and editing:

Library Management: Organize, search, and edit metadata for your eBook collection.
Format Conversion: Convert between major eBook formats (EPUB, MOBI, AZW3, PDF, etc.).
eBook Editing: Direct HTML/CSS editing, structure adjustment, spell check, and code snippets.
Device Sync: Seamlessly transfer and sync eBooks with popular eReaders.
Content Fetching: Download news and web content as eBooks.
eBook Viewer: Read and annotate eBooks in all major formats.
Extensibility: Enhance Calibre with plugins and interface customization.

Edit EPUB Books

Open Calibre’s Book Editor First.

Clean and Organize Resource Files

Tools > Upgrade book internals
Tools > Beautify all files
Tools > Compress images losslessly

Tools > Arrange into folders

Text (HTML) files - text/
Style (CSS) files - styles/
Images            - images/
Fonts             - fonts/

Fonts

Organize fonts definition in styles/fonts.css file.

English Fonts

🎯 Comparative Analysis

Category	Literata	Charis SIL	Noto Serif / Sans	Source Serif 4
Download	🔗 Google Fonts	🔗 SIL International	🔗 Google Fonts	🔗 Google Fonts
Font Type	Serif	Serif	Serif (or Sans-serif)	Serif
Aesthetic Style	Modern, literary, elegant	Traditional, academic, practical	Minimalist, clean, system-neutral	Neutral, bookish, classically inspired
Screen Display	✅ Excellent on screen, optimized by Google	◯ Designed more for print, slightly dense onscreen	✅ Excellent screen readability	✅ Well-optimized for screen and print
Long Reading Comfort	✅ Very high, great for long-form reading	◯ Slightly tight line spacing; better for print	◯ Clear but less “warm” for fiction	✅✅ Very high—gentle contrast, soft serifs for extended reading
Apple Books Performance	✅ Great support, looks elegant and consistent	◯ Works, but looks more academic/formal	✅ Modern and reliable appearance	✅ Strong rendering on Apple devices (Safari, Apple Books, iOS/macOS)
Multilingual Support	◯ Latin script focus	✅ Especially strong for phonetics, IPA	✅ Full Unicode support, including CJK and RTL	✅ Excellent Latin script + full diacritic/accents coverage for multilingual content
Best For Fiction Reading	✅✅✅ Ideal for most novels	◯ Best for philosophical or scholarly fiction	◯ General-purpose, multilingual documents	✅✅✅ Excellent for novels with multilingual phrases (e.g. French, Spanish, German inline)

Chinese Fonts

🏮 Simplified Chinese

@charset "utf-8";
@font-face {
  font-family: 'songti';
  src:
    local('Noto Serif SC'), local('Source Han Serif SC'), local('STSong'),
    local('宋体'), local('华文中宋'), local('Noto Serif TC'),
    local('Source Han Serif TC'), local('Songti TC'), local('PMingLiU'),
    local('Georgia'), local('Times New Roman');
}
@font-face {
  font-family: 'heiti';
  src:
    local('PingFang SC'), local('Microsoft YaHei'), local('微软雅黑'),
    local('Heiti SC'), local('PingFang TC'), local('Heiti TC'),
    local('JhengHei'), local('Helvetica'), local('Arial');
}
@font-face {
  font-family: 'kaiti';
  src:
    local('KaiTi'), local('KaiTi_GB2312'), local('KaiTi SC'), local('楷体'),
    local('DFKai-SB'), local('KaiTi TC'), local('BiauKai'), local('cwTeKai');
}

📜 Traditional Chinese

@charset "utf-8";
@font-face {
  font-family: 'songti';
  src:
    local('Noto Serif TC'), local('Source Han Serif TC'), local('Songti TC'),
    local('PMingLiU'), local('Noto Serif SC'), local('Source Han Serif SC'),
    local('STSong'), local('宋体'), local('华文中宋'), local('Georgia'),
    local('Times New Roman');
}
@font-face {
  font-family: 'heiti';
  src:
    local('PingFang TC'), local('Heiti TC'), local('JhengHei'),
    local('PingFang SC'), local('Microsoft YaHei'), local('微软雅黑'),
    local('Heiti SC'), local('Helvetica'), local('Arial');
}
@font-face {
  font-family: 'kaiti';
  src:
    local('KaiTi TC'), local('DFKai-SB'), local('BiauKai'), local('cwTeKai'),
    local('KaiTi SC'), local('KaiTi'), local('KaiTi_GB2312'), local('楷体');
}

General styles

🅰️ English

@charset "utf-8";
body {
  margin: 0;
  padding: 1em;
  font-size: 1em;
  line-height: 1.6;
  text-align: justify;
  text-justify: inter-word;
  -webkit-font-smoothing: antialiased;
  -webkit-text-size-adjust: none;
  font-family:
    <Fonts Here!>,
    serif;
  /* footnote counter */
  counter-reset: footnote 0;
}
h1,
h2,
h3,
h4 {
  font-weight: bold;
  line-height: 1.3;
  margin-top: 2em;
  margin-bottom: 0.5em;
  font-family:
    <Fonts Here!>,
    sans-serif;
}
h1 {
  font-size: 1.8em;
  margin-top: 2.5em;
  margin-bottom: 1.2em;
}
h2 {
  font-size: 1.5em;
}
h3 {
  font-size: 1.3em;
}
h4 {
  font-size: 1.1em;
}
blockquote {
  margin: 1em 2em;
  padding-left: 1em;
  border-left: 3px solid #ccc;
  font-style: italic;
  color: #555;
  line-height: 1.6;
}
p {
  text-indent: 2em;
  margin: 0.5em 0;
}
strong {
  font-weight: bold;
}
cite,
em {
  font-style: italic;
}
.center {
  text-align: center;
}
.right {
  text-align: right;
}
p.center,
p.right,
blockquote p {
  text-indent: 0;
}
a.footnote {
  text-decoration: none;
  font-weight: normal;
}
.footnote-content {
  font-size: 0.8em;
  margin-top: 4em;
  line-height: 1.4;
}
.footnote-content a.footnote:last-child::after {
  content: '↩';
}
a.footnote sup::after {
  counter-increment: footnote;
  content: counter(footnote);
  padding: 0 0.2em;
}
img {
  max-width: 100%;
}
/* - custom styles below - */

🀄 Chinese

@charset "utf-8";
body {
  margin: 0;
  padding: 1em;
  font-size: 1.05em;
  line-height: 1.8;
  text-align: justify;
  text-justify: inter-ideograph;
  -webkit-font-smoothing: antialiased;
  -webkit-text-size-adjust: none;
  font-family: 'songti', 'STSong', '宋体', serif;
  /* footnote counter */
  counter-reset: footnote 0;
}
h1,
h2,
h3,
h4 {
  font-weight: bold;
  line-height: 1.4;
  margin-top: 2em;
  margin-bottom: 0.5em;
  font-family: 'heiti', 'PingFang SC', 'Microsoft YaHei', sans-serif;
}
.kaiti,
blockquote {
  font-style: normal;
  letter-spacing: 0.03em;
  line-height: 1.6;
  font-family: 'kaiti', 'KaiTi', 'DFKai-SB', serif;
}
h1 {
  font-size: 1.6em;
  margin-top: 2.5em;
  margin-bottom: 1.5em;
}
h2 {
  font-size: 1.4em;
}
h3 {
  font-size: 1.2em;
}
h4 {
  font-size: 1.1em;
}
blockquote {
  color: #555;
  margin: 2em;
  margin-right: 0;
}
p {
  text-indent: 2em;
  margin: 0.2em 0;
}
strong {
  font-weight: bold;
}
cite,
em {
  font-style: italic;
}
.center {
  text-align: center;
}
.right {
  text-align: right;
}
p.center,
p.right {
  text-indent: 0;
}
a.footnote {
  text-decoration: none;
  font-weight: normal;
}
.footnote-content {
  font-size: 0.8em;
  margin-top: 4em;
}
.footnote-content a.footnote:last-child::after {
  content: '↩';
}
a.footnote sup::after {
  counter-increment: footnote;
  content: counter(footnote);
  padding: 0 0.2em;
}
img {
  max-width: 100%;
}
a.footnote img {
  width: 1em;
  height: 1em;
  vertical-align: super;
}
/* - custom styles below - */

Key EPUB Footnote and Noteref Attributes

Note: Use of the epub:type attribute requires the inclusion of the namespace xmlns:epub="http://www.idpf.org/2007/ops in the <html> element.

epub:type="noteref"
Marks a link as a footnote reference in the main text.
Example:

<a epub:type="noteref" role="doc-noteref" href="#footnote-1" id="return-1">
  <sup>[1]</sup>
</a>

epub:type="footnote"
Marks the actual footnote content, usually at the end of a chapter or page.
Example:

<aside id="footnote-1" epub:type="footnote" role="doc-footnote">
  Footnote content here. <a href="#return-1">↩</a>
</aside>

role="doc-noteref" / role="doc-footnote"
ARIA roles for accessibility, helping screen readers and eBook readers identify references and notes.
id and href
Used for linking between the reference and the footnote content.

Best practice for Apple Books: Use <aside> with epub:type="footnote". The text is hidden in the main body and only appears in the popup. See Pop-up Footnotes.

Productivity Tips: Custom Code Snippets in Calibre

Calibre’s editor allows you to create and insert custom code snippets for repetitive tasks:

Go to Preferences > Editor settings > Manage snippets
To use it in editor, press Ctrl+j after trigger.

Insert footnote anchor
Trigger: <fna
Template:

<a
  epub:type="noteref"
  role="doc-noteref"
  class="footnote"
  href="#fn-A-$1"
  id="fn-B-$1"
>
  <sup aria-label="Footnote $1"></sup>
</a>

To use it in html, type <fna, press Ctrl+j, type <index> number and press Ctrl+j again.

Insert footnote content
Trigger: <fnc
Template:

<aside class="footnote-content" epub:type="footnote">
  <ol></ol>
</aside>

Insert footnote item
Trigger: <fni
Template:

<li epub:type="footnote" role="doc-footnote" id="fn-A-$1">
  $2<a class="footnote" href="#fn-B-$1" aria-label="Back to reference"></a>
</li>

Apple Books Compatibility Notes

Use Standard HTML: Stick to <a>, <aside>, and basic CSS for maximum compatibility.
Avoid JavaScript: Apple Books does not support JavaScript in EPUBs.
SVG and Advanced CSS: Use with caution; some features may not render as expected.
Font Embedding: Use standard fonts or properly embed custom fonts.
Footnote Navigation: Always provide a way to return from the footnote to the main text (e.g., a back arrow link).

Additional Best Practices

Test on Multiple Devices: Always preview your EPUB in Calibre, Apple Books, and other readers.
Keep Structure Simple: Simple HTML and CSS ensure the widest compatibility.
Validate EPUB: Use Calibre’s “Check Book” tool to catch errors early.
Remove Unused Code: Clean up unused snippets and styles before publishing.

References

By leveraging Calibre’s productivity features and following these best practices, you can efficiently create professional, accessible, and compatible EPUB eBooks.