Tag: Markdown

  • Create Clean EPUBs using Calibre

    There are several reasons to generate a clean EPUB.

    • Consistency. Consistent styles to maintain the same look and feel across platforms.
    • Simplicity. With fewer interactions between CSS styles, changes are easier to implement and track.
    • Human readable. Easy to find chapters, sections and styles.
    • Convertible. Simple styles lend to consistent conversions between formats. Creates Microsoft Word documents with fewer embedded Styles.

    Of course, there are disadvantages.

    • Investment. Generating documents requires time and effort. However, since the the styles are reusable, the level of effort for future releases is reduced.
    • Technical knowledge. This requires more than a passing familiarity with Markdown, XHTML, CSS, and Calibre. However, there is pleny of documentation available online to help.

    While the disadvantages can dissuade people from experimenting with this capability, I found it simplified my eBook submission process. I can target Draft2Digital, Google Play, and Amazon Kindle, using one EPUB, and maintain advanced formatting like realistic text messaging throughout.

    This tutorial focuses on features Calibre offers to make EPUB management easier. These tips and tricks may prove invaluable for debugging an eBook in the future.

    (more…)

  • Clean Manuscripts Using Markdown

    Modern word processors work with the What You See is What You Get paradigm. While that’s mostly true for simple documents, inconsistencies are often introduced into complex documents. This includes but is not limited to:

    • Formatting differences introduced by Copy and Paste operations.
    • Different styles applied throughout. E.g. Some paragraphs are 1.2 line spaces, while others are set to 1.15 line spaces.
    • Selection errors. E.g. The user selected more than expected while formatting text, such as Italics.

    Some of these examples may go undetected until the work is published. These inconsistencies further complicate fault finding an EPUB, as they lead to additional styles and tags being introduced into the code.

    Markdown is a human markup language that permits users to use formatting like Bold, Italics, Monospace, and Strike Through without any knowledge of the underlying code. This simple syntax can be leveraged to generate clean manuscripts.

    Sample Markdown Text

    # Clean Manuscripts Using Markdown
    
    Modern word processors often subscribe to the [What You See is
    What You Get](http://en.wikipedia.org/wiki/WYSIWYG) paradigm.
    While true for simple documents, inconsistencies are easy to
    find in complex documents. These include but are not limited to:
    
    * Formatting differences introduced by _Copy_ and _Paste_
      operations.
    * Different styles applied throughout. E.g. Some paragraphs are
      1.2 line spaces, while others are set to 1.15 line spaces.
    * Selection errors. E.g. The user selected more than expected
      prior to formatting text, such as _Italics_.
    
    [Markdown](http://en.wikipedia.org/wiki/Markdown) is a human
    markup language that permits users to use formatting like
    **Bold**, _Italics_, `Monospace`, and ~~Strike Through~~ without
    any knowledge of the underlying code. The simple Markdown’s
    syntax can be leveraged to generate _clean_ manuscripts.
    

    Fortunately, Google Docs offers extensions that converts documents to and from Markdown on demand. The overall process is straightforward:

    • Convert the manuscript to Markdown.
    • Confirm the formatting.
    • Create a new document with the desired styles.
    • Import the Markdown manuscript into the new document.
    • Export to other formats as needed.
    (more…)

Search