From 62243cd0b5262e14df7e7b5b7103b5b2e006cab5 Mon Sep 17 00:00:00 2001 From: "David T. Sadler" Date: Wed, 19 May 2021 23:46:22 +0100 Subject: Add more to css --- .../2020-03-30/creating-an-ebook-with-markdown/index.html | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) (limited to 'www/posts/markdown/2020-03-30/creating-an-ebook-with-markdown') diff --git a/www/posts/markdown/2020-03-30/creating-an-ebook-with-markdown/index.html b/www/posts/markdown/2020-03-30/creating-an-ebook-with-markdown/index.html index b60c238..acbe24a 100644 --- a/www/posts/markdown/2020-03-30/creating-an-ebook-with-markdown/index.html +++ b/www/posts/markdown/2020-03-30/creating-an-ebook-with-markdown/index.html @@ -5,6 +5,9 @@ Creating an Ebook With Markdown + + + @@ -21,12 +24,12 @@

Creating an Ebook With Markdown

Mon 30th March 2020 By David T. Sadler.

Pandoc is a great tool for converting a file in one markup format into another. This means we can use it to convert a file written in Markdown into an EPUB file that is supported by many e-readers.

Lets start by writting a very simple markdown file called example_ebook.md.

---
 title:
 - type: main
-text: Example Ebook
+  text: Example Ebook
 - type: subtitle
-text: An Ebook created from a Markdown file
+  text: An Ebook created from a Markdown file
 creator:
 - role: author
-text: David Sadler
+  text: David Sadler
 publisher: Published by myself
 ---
 
@@ -54,6 +57,8 @@ This is the second paragraph of chapter 2.
 
 This is the first paragraph of chapter 3.
 
-This is the second paragraph of chapter 3.

Note that the file begins with a YAML metadata block that starts and ends with three hyphens (---). This allows you to specify EPUB metadata such as the title and author.

Converting this to EPUB is done by running pandoc.

$ pandoc example_ebook.md -t epub3 --toc -o example_ebook.epub

There are several options that need to be passed to pandoc.

You can now copy the file example_ebook.epub to any device that supports the format or use one of the many software readers such as Calibre. However, if you wish to read this on a Kindle device you will need to convert it to the Mobi format.

Amazon provides a command line tool called KindleGen that can convert our EPUB file into the Mobi format. After downloading the tool just run it as shown below.

$ kindlegen example_ebook.epub

This will create a file called example_ebook.mobi that you can copy to your Kindle to read.

Links

Pandoc.Markdown.EPUB.YAML metadata block.EPUB metadata.EPUB v3 book.Calibre Application.Mobi Format.KindleGen Application.Markdown - Read More Posts.

I don't have comments as I don't want to manage them. You can however contact me at the below address if you want to.

Email david@davidtsadler.comThe contents of this site is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Copyright © 2021 David T. Sadler.

Return to Homepage.
+This is the second paragraph of chapter 3.

Note that the file begins with a YAML metadata block that starts and ends with three hyphens (---). This allows you to specify EPUB metadata such as the title and author.

Converting this to EPUB is done by running pandoc.

$ pandoc example_ebook.md -t epub3 --toc -o example_ebook.epub

There are several options that need to be passed to pandoc.

You can now copy the file example_ebook.epub to any device that supports the format or use one of the many software readers such as Calibre. However, if you wish to read this on a Kindle device you will need to convert it to the Mobi format.

Amazon provides a command line tool called KindleGen that can convert our EPUB file into the Mobi format. After downloading the tool just run it as shown below.

$ kindlegen example_ebook.epub

This will create a file called example_ebook.mobi that you can copy to your Kindle to read.

Links

Pandoc.Markdown.EPUB.YAML metadata block.EPUB metadata.EPUB v3 book.Calibre Application.Mobi Format.KindleGen Application.Markdown - Read More Posts.

I don't have comments as I don't want to manage them. You can however contact me at the below address if you want to.

Email david@davidtsadler.com

License

The contents of this site is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Copyright © 2021 David T. Sadler.

Return to Homepage. + + -- cgit v1.2.3-13-gbd6f