EBOOK-CONVERT(1) calibre EBOOK-CONVERT(1)
NAME
ebook-convert - ebook-convert
ebook-convert input_file output_file [>>>>>]
>>>>>>>>>>>>>>>>>>>>>>
input_file >>>>>>>>>output_file
>>>>>>>>>>>>>>>>>>>>>>> 2
>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>output_file
>>>>>>>>>>>>>>>>output_file>>>>>>
EXT (EXT >>>>>>>>>>)
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>output_file>>>>>>>>>>>>>>>>>>>>HTML>>>>>>>>>>>>>open
e-book>(OEB)
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
-h >>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>
>>>>>>>>>> ebook-convert
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>:
"/some path/with spaces"
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>:
ebook-convert myfile.input_format myfile.output_format -h
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>
o >>>>>>>
o >>>>>>>
o >>
o >>>>>>>>>>>
o >>>>>
o >>>>>
o >>
o >>
o >>>>
--help, -h
>>>>>>>>>>>>>>>>>
--input-profile
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>:
cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad,
irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony,
sony300, sony900
--list-recipes
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>:
ebook-convert "Recipe Name.recipe" output.epub
--output-profile
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>:cybookg3,
cybook_opus, default, hanlinv3, hanlinv5, illiad, ipad, ipad3,
irexdr1000, irexdr800, jetbook5, kindle, kindle_dx, kindle_fire,
kindle_oasis, kindle_pw, kindle_pw3, kindle_scribe,
kindle_voyage, kobo, msreader, mobipocket, nook, nook_color,
nook_hd_plus, pocketbook_inkpad3, pocketbook_lux, pocketbook_hd,
pocketbook_900, pocketbook_pro_912, galaxy, sony, sony300,
sony900, sony-landscape, sonyt3, tablet, generic_eink,
generic_eink_hd, generic_eink_large
--version
>>>>>>>>>>>>>>>>>>>>
>>>>>>>
>>>>>> mobi >>>>>>>>>>
--input-encoding
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>
epub>>>>>>>>>>>>>>>>>>>>>
--dont-split-on-page-breaks
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>2>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--epub-flatten
>>>>>>>>FBReaderJ>EPUB>>>>>>>>>>>>>>>>EPUB>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--epub-inline-toc
>>>>>>>>>>>>>>>>>>>>>>>>>
--epub-max-image-size
The maximum image size (width x height). A value of none means
use the screen size from the output profile. A value of profile
means no maximum size is specified. For example, a value of
100x200 will cause all images to be resized so that their width
is no more than 100 pixels and their height is no more than 200
pixels. Note that this only affects the size of the actual image
files themselves. Any given image may be rendered at a different
size depending on the styling applied to it in the document.
--epub-toc-at-end
>>>>>>>>>>>>>>>>>>>>>>>>>>
--epub-version
>>>>EPUB>>>>>>>>>>>>>>>>>>>>>>>EPUB2>>>EPUB3>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--extract-to
Extract the contents of the generated book to the specified
folder. The contents of the folder are first deleted, so be
careful.
--flow-size
>>>>>>(KB)>>>HTML>>>>>>>>>>>>>>EPUB>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
260KB> Adobe Digital Editions
>>>>>>>>>0>>>>>>>>>>>>>>>>
--no-default-epub-cover
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--no-svg-cover
SVG>>>>>>>>>>>>>>>>>>>>iPhone>
JetBook
Lite>>>>SVG>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--preserve-cover-aspect-ratio
SVG>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--pretty-print
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--toc-title
Title for any generated inline table of contents.
>>
>>>>>>>>>>>>>>>>>>
--asciiize
Unicode>>>ASCII>>>>>>>>>Unicode>>>ASCII>>>>>>>>>>>>>>>>>>>>>>>>>>>>
"Pele" >
"Pele">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>calibre>>>>>>>>>>>>>>>>>
--base-font-size
>>>>>>>>>>>pt>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>0>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--change-justification
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>:
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--disable-font-rescaling
>>>>>>>>>>>>>>>>>>>>
--embed-all-fonts
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
EPUB, AZW3, DOCX, PDF
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--embed-font-family
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>EPUB,
AZW3, DOCX
>>>>>>>>>>>>>>>>>>>>>
--expand-css
>>>>>> calibre >>CSS>margin, padding, border,
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>Nook>>>>>>>Nook>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--extra-css
CSS>>>>>>>>>>>>CSS>>>>>>>>>>>CSS>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--filter-css
CSS>>>>>>>>>>>>>>>>>>CSS>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>font-family,color,margin-left,margin-right
--font-size-mapping
CSS>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>12,12,14,16,18,20,22,24>xx-small
>>
xx-large>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--insert-blank-line
>>>>>>>>>>>>>>>>>>>>>>>>
>
>>>>>>>>>>>>>>>>>>>>
--insert-blank-line-size
>>>>>>>>>>>>>>>>em>>>>>>>>>>>>>>>>>>>>>>>>>>>
--keep-ligatures
Preserve ligatures present in the input document. A ligature is
a combined character of a pair of characters like ff, fi, fl et
cetera. Most readers do not have support for ligatures in their
default fonts, so they are unlikely to render correctly. By
default, calibre will turn a ligature into the corresponding
pair of normal characters. Note that ligatures here mean only
unicode ligatures not ligatures created via CSS or font styles.
This option will preserve them instead.
--line-height
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--linearize-tables
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--margin-bottom
>>>>>pt>>>>>>>>>>>>5.0>>>>>0>>>>>>>>>>>>>>>>>>>>
(>>>>>>>>>>>>>>>>>>>>>>>>>>>)>>:
PDF>DOCX>>>>>>>>>>>>>>>>>>>>>>>>>>>
--margin-left
>>>>>pt>>>>>>>>>>>>5.0>>>>>0>>>>>>>>>>>>>>>>>>>>
(>>>>>>>>>>>>>>>>>>>>>>>>>>>)>>:
PDF>DOCX>>>>>>>>>>>>>>>>>>>>>>>>>>>
--margin-right
>>>>>pt>>>>>>>>>>>>5.0>>>>>0>>>>>>>>>>>>>>>>>>>>
(>>>>>>>>>>>>>>>>>>>>>>>>>>>)>>:
PDF>DOCX>>>>>>>>>>>>>>>>>>>>>>>>>>>
--margin-top
>>>>>pt>>>>>>>>>>>>5.0>>>>>0>>>>>>>>>>>>>>>>>>>>
(>>>>>>>>>>>>>>>>>>>>>>>>>>>)>>:
PDF>DOCX>>>>>>>>>>>>>>>>>>>>>>>>>>>
--minimum-line-height
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>calibre>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>120>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>2>>>>>>>>>>>>>>>>>240>>>>>>>>
--remove-paragraph-spacing
>>>>>>>>>>>>>>>>>>>>>>>>>1.5em>>>>>>>>>>>>>>>>>>>>
>
>>>>>>>>>>>>>>>>>>>>>>
--remove-paragraph-spacing-indent-size
calibre>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>em>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>calibre>>>>>>>>>>>>>
--smarten-punctuation
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>https://daringfireball.net/projects/smartypants
>>>>>>>>>>
--subset-embedded-fonts
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--transform-css-rules
>>>>CSS>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>calibre
GUI>>>>>>>>>>>>>>>>>>>>>>>>>>>->>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--transform-html-rules
>>>>>> HTML
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>calibre
GUI
>>>>>>>>>>>>>>>>>>>>>>>>>>>
-> HTML
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--unsmarten-punctuation
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--enable-heuristics>>>>>>>>>>>>>>>>>>>>>--disable-*
>>>>>>>>>>>>>>>>>>>
--disable-dehyphenate
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--disable-delete-blank-paragraphs
2>>>>>>>>>>>>>>>>>>>>>>>
--disable-fix-indents
>>>>>>>>>>>>>>>>>>>>>>>>>>CSS>>>>>>>>>>>>>
--disable-format-scene-breaks
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--disable-italicize-common-cases
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--disable-markup-chapter-headings
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>h2>h3>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--disable-renumber-headings
>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--disable-unwrap-lines
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--enable-heuristics
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--html-unwrap-factor
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>0.4>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--replace-scene-breaks
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>
--search-replace
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>(>>>>>>>>>>>)>>>>>>>>>>>>>>>>>>>>>>>Python>>>>>>>>>>>>>>>>>>>>>
UTF-8 >>>>>>>>>>>
--sr1-replace
>>1->>>>>>>>>>>>>>>>>>>
--sr1-search
>>1->>>>>>>>>>>>>>>>>>>>>>>>>>
--sr2-replace
>>2->>>>>>>>>>>>>>>>>>>
--sr2-search
>>2->>>>>>>>>>>>>>>>>>>>>>>>>>
--sr3-replace
>>3->>>>>>>>>>>>>>>>>>>
--sr3-search
>>3->>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>
>>>>>>>>>>>>>>>>
--add-alt-text-to-img
When an
tag has no alt attribute, check the associated
image file for metadata that specifies alternate text, and use
it to fill in the alt attribute. The alt attribute improves
accessibility by providing text descriptions for users who
cannot see or fully interpret visual content.
--chapter
>>>>>>>>>>>>>XPath>>>>>>>>>>>
>>> >>>>> "chapter", "book", "section",
"prologue", "epilogue", "part" >>>>>>>>>
class="chapter"
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>"/"
>>>>>>>>XPath>>>>>>>>>>calibre>>>>>>>>>>>>>>>>>>>
--chapter-mark
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--disable-remove-fake-margins
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>calibre>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--insert-metadata
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--page-breaks-before
XPath>>>>>>>>XPath>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>:
/ >>>>>>>>>>
--prefer-metadata-cover
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--remove-first-image
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>calibre>>>>>>>>>>>>2>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--start-reading-at
>>>>>>>>>>>>>>XPath>>>>>>>>>>>>>>>>(>>>>>>>>Kindle)>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>calibre>>>>>>>>>>XPath>>>>>>>>>>>>>>>>>
>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--duplicate-links-in-toc
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>1>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--level1-toc
>>>>>> 1
>>>>>>>>>>>>>>>XPath>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>XPath>>>>>>>>>>calibre>>>>>>>>>>>>>>>>>>>>
--level2-toc
>>>>>> 2
>>>>>>>>>>>>>>>XPath>>>>>>>>>>>>>>>>>>>
1
>>>>>>>>>>>>>XPath>>>>>>>>>>calibre>>>>>>>>>>>>>>>>>>>>
--level3-toc
>>>>>> 3
>>>>>>>>>>>>>>>XPath>>>>>>>>>>>>>>>>>>>
2
>>>>>>>>>>>>>XPath>>>>>>>>>>calibre>>>>>>>>>>>>>>>>>>>>
--max-toc-links
>>>>>>>>>>>>>>>>0>>>>>>>>>>>>>>>>>:
50
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--no-chapters-in-toc
>>>>>>>>>>>>>>>>>
--toc-filter
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--toc-threshold
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>:
6
--use-auto-toc
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>
>>>>>>>>>>>>>
--author-sort
>>>>>>>>>>>>>>>>
--authors
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--book-producer
>>>>>>>>>>>>
--comments
>>>>>>>>>>
--cover
>>>>>>>>>>>>>>URL>>>>>
--isbn >>ISBN>>>>>>>>>>
--language
>>>>>>>>>
--pubdate
>>>>>>
(>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>)
--publisher
>>>>>>>>>>>
--rating
>>>>>>>>>>>>>>>>>
--read-metadata-from-opf, --from-opf, -m
>>>>OPF>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--series
>>>>>>>>>>>>
--series-index
>>>>>>>>>>>>>>>>>>
--tags >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--timestamp
>>>>>>>>>>>>>>>>>>>>>>>>>
--title
>>>>>>>
--title-sort
>>>>>>>>>>>>>>>>>>>
>>>>
>>>>>>>>>>>>>>>>>>
--debug-pipeline, -d
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--verbose, -v
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>2>>>>>>>>>>>>>>>>>>1>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
AUTHOR
Kovid Goyal
COPYRIGHT
Kovid Goyal
8.0.1 3> 21, 2025 EBOOK-CONVERT(1)