EBOOK-CONVERT(1) calibre EBOOK-CONVERT(1)
NAME
ebook-convert - ebook-convert
ebook-convert input_file output_file [options]
Convert an e-book from one format to another.
input_file is the input and output_file is the output. Both must be
specified as the first two arguments to the command.
The output e-book format is guessed from the file extension of
output_file. output_file can also be of the special format .EXT where
EXT is the output file extension. In this case, the name of the output
file is derived from the name of the input file. Note that the
filenames must not start with a hyphen. Finally, if output_file has no
extension, then it is treated as a folder and an "open e-book" (OEB)
consisting of HTML files is written to that folder. These files are the
files that would normally have been passed to the output plugin.
After specifying the input and output file you can customize the
conversion by specifying various options. The available options depend
on the input and output file types. To get help on them specify the
input and output file and then use the -h option.
For full documentation of the conversion system see >>> >>
Whenever you pass arguments to ebook-convert that have spaces in them,
enclose the arguments in quotation marks. For example: "/some path/with
spaces"
The options and default values for the options change depending on both
the input and output formats, so you should always check with:
ebook-convert myfile.input_format myfile.output_format -h
Below are the options that are common to all conversion, followed by
the options specific to every input and output format.
o >> >>
o >> >>
o >>>
o >>> >>> >>(Heuristic) >>
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" >>.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, generic_eink, generic_eink_hd,
generic_eink_large, tablet
--version
>>>>> >>> >>> > >>>>>.
>> >>
mobi >> >>> >>> >>>> >>>>>.
--input-encoding
>> >>> >> >>>> >>>>>. >
>>> >>>> >> >>> >>> >>>>
>>>>>. >>> >>> >>> >>>
>>> >>> >> >>>> >> >>>>>.
>> >>
epub >>> >>> >>>> >>>>>.
--dont-split-on-page-breaks
> >>>> >>>> >>> >>>. >>>
>> >>> > >> >> >> > >>>>
>>>> >>>>>. >>> >>>> >> >
>>> >>>> >> >>> >>> > >>
>>>. >>>, >>>>> >>> >> >>>
>> > > >> >>> >> >>> > >>>
>>>>> >> >>>.
--epub-flatten
> >>> EPUB> FBReaderJ>> >>>> >>>
>>>> >>>>>. > >>> 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
The version of the EPUB file to generate. EPUB 2 is the most
widely compatible, only use EPUB 3 if you know you actually need
it.
--extract-to
Extract the contents of the generated EPUB file to the specified
folder. The contents of the folder are first deleted, so be
careful.
--flow-size
Split all HTML files larger than this size (in KB). This is
necessary as most EPUB readers cannot handle large file sizes.
The default of 260KB is the size required for Adobe Digital
Editions. Set to 0 to disable size based splitting.
--no-default-epub-cover
>>>, >> >>> >>> >> > >>>
>>>> >> >>, >> >>> >>, >>
>> >> >>>>>. > >>> >>>>>>
>>> >>>> >>>>.
--no-svg-cover
> >>> SVG> >>>> >>>>. EPUB>
iPhone>> JetBook Lite>> SVG> >>>> >>
>>> >>> >>>> > >>> >>>>>.
> >>> >>>> >>>, >>> >>>
>>>> >>> > >>> >>>> >>>.
--preserve-cover-aspect-ratio
SVG >>> >>> > > >>> >>>> >>>
>> >>> >> >>> >>> >>>
>>>>> >> >> >>(>> > >>
>>)> >>>>>. >, >>>> >> >>
>>> >>> >> >>>> >> > >>>
>>>> >>>> >>>>. > >>> >>>
>>>> >> >>> > >>> >>>>
>>>>.
--pretty-print
>>> >>, >> >>>>> >>> >> >
>> >>> >>> >>>>> >>>>>.
>> >> >>>>> >>>> >>> >>>
>> > >>>>.
--toc-title
Title for any generated inline table of contents.
>>>
>>> >>>> >>>> >>>>>
--asciiize
Transliterate Unicode characters to an ASCII representation. Use
with care because this will replace Unicode characters with
ASCII. For instance it will replace "Pele" with "Pele". Also,
note that in cases where there are multiple representations of a
character (characters shared by Chinese and Japanese for
instance) the representation based on the current calibre
interface language will be used.
--base-font-size
>> >> >>>> pts >>>>>. >>>>
>> >> >> >>> > >>> >>>>
>>>>>. > > >>> >>>> >>>>
>>> > >> >>>>, >>> >> >>>
>>>> >>> > >> >> > >>>>. >
>> >>> 0> >>, >> >> >>> >>>
>>> >> >>>> >>>> >>>>>.
--change-justification
>>> >> >>> >>>>>. ">>" >>
>>> >> >>> >>>> >> >>>(>,
>>>> >>) >>>> >>>>>. ">>
>>" >> >> >>> >> >>> >>
>>>>> >>>>>. ">>"(>>>) >>
>> >>> >> >>> >>> >>>>. >>
>> >>> >> >>> >>>>>.
--disable-font-rescaling
>> >>> >> >> >>> >>>>>>>.
--embed-all-fonts
>> >>>> >>>>> >> >>>> >>
>> >>> >>>>>. >>> >>>>>
>>> >>>> >>>> >>>>>. >>>
>>>>> >>> EPUB, AZW3, DOCX >> PDF> >>
>> >>> >>>> >>>> >>>>>. >
>>> >>> >>> >>> > >> >>>
>>>>> >>> >>>>>>.
--embed-font-family
>>> >> >>> >> >>>>>. >>
>>>> ">>" >>> >>>>>. >>
>>> >> >>> >>>> >> > >>
>>> >>>> > >>>>. >> >>> >>
>>> >>>> >> >>>> >>> >>>
> >>>>. >> >>> >> EPUB, AZW3 > DOCX>
>> >> >> >>>>> >>>>>.
--expand-css
By default, calibre will use the shorthand form for various CSS
properties such as margin, padding, border, etc. This option
will cause it to use the full expanded form instead. Note that
CSS is always expanded when generating EPUB files with the
output profile set to one of the Nook profiles as the Nook
cannot handle shorthand CSS.
--extra-css
CSS >>>>> >> >> CSS> >> >>>>>.
> CSS> >> >>> >>> >>> >>>>>
>> >>> >>>>> > >>> > >>>>.
--filter-css
CSS >>> >>>> >>>>, >>> >>>,
CSS >>> >>. >>>> >>>> >>> >>
>>> >>> >>>> >> >>> >>
>>> >>>>>. >>: font-family, color,
margin-left, margin-right
--font-size-mapping
CSS >> >> >>> pts >>> >>>>>
>>>>>. >> >> >>,
12,12,14,16,18,20,22,24> >>>>. > >>> xx-small
>> xx-large>>> >>> >> >>>, >>>
>>> >> huge font> >> >>>>>. >>
>> >>> >>>>> >>>>> >>
>>> >>> >>>>> >>> > >>>
>>>>>. >>>>>> >>>> >>>
>> >>>> >>> >>> >>>>>.
--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
pt >>> > >> >>>>>. >>>> >
>>> >> >>>> >> >>>>>
>>>>>. >>>> >>, >> > >>
>>> > >>>>>. >>>>>, > > >>
>>> >>>> >>>>.
--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
>> >>> >>> >> >>> >> >>>>
>>>> >> > >>>>>. >>>> >>
>>> >>>> >> >>>> >> >>>
>>> > >>> > >>> >>> >>>.
>>>>>>> 0>> >>>>>>. >>>>
120%>>>. >> >> >> >>> >>>
>>> >>> >> >> >> >>> >>
>>>>> > >>> >>>>>>. >> >>,
>>> 240>> >>>> ">> >>" >>>>
>> > >>>>.
--remove-paragraph-spacing
>> >>> >>> >>>>. >> >>>
1.5em> >>>>> >>>>>. >> >>>>
>> >>> >>(
,
>>)> >>>>
>>> >>>> >>>>.
--remove-paragraph-spacing-indent-size
>>>> >> >>> > >>> >>> >,
>>>> >> >>>>> >> >>>
>>>> >>> >>>>> >>>>>. >
>>> > >>>>> >>> (em >>>)
>>>>>. > >> >>> >>>> >>,
>> >>>> >>> >>>>>
>>>>>(>, >>>> >>>>> >>>>
>>).
--smarten-punctuation
Convert plain quotes, dashes and ellipsis to their
typographically correct equivalents. For details, see
https://daringfireball.net/projects/smartypants.
--subset-embedded-fonts
>> >>> >>(embedded font)> >>> >>
>>> >>> >>>>. >>> >> >>> >
>>>> >>> >>>> >>>>> >>
>> >>> >>>> >>>. >>>> >>
>>> >>>> >>> >>> > >>>
>>>> >> >> >>>>>.
--transform-css-rules
Path to a file containing rules to transform the CSS styles in
this book. The easiest way to create such a file is to use the
wizard for creating rules in the calibre GUI. Access it in the
"Look & feel->Transform styles" section of the conversion
dialog. Once you create the rules, you can use the "Export"
button to save them to a file.
--transform-html-rules
Path to a file containing rules to transform the HTML in this
book. The easiest way to create such a file is to use the wizard
for creating rules in the calibre GUI. Access it in the "Look &
feel->Transform HTML" section of the conversion dialog. Once you
create the rules, you can use the "Export" button to save them
to a file.
--unsmarten-punctuation
>> >>>, >>, >>>>>> >>>>
>>> >>> >>>> >>>>>.
>>> >>> >>(HEURISTIC) >>
>>> >>>> >>> >> >>> >>>>
>>>>>. >>>>> >>>>>>. >>>>>>
--enable-heuristics > >>>>>. >> >>> --disable-*
> >>>> >>>>> > >>>>.
--disable-dehyphenate
>> >>> >> >>> >>> >>>>
>>>>>. >>>> >>>>> >>
>>>>> >>> >>>> >> >>>>
>> > >>> >>>>>.
--disable-delete-blank-paragraphs
>> >>> >>> > >>> >> >>
>>>> > > >>>> >>>>>
--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>
1>>> >>> >>>>. >>>> 0.4>>, >
>> >>>> >> >>>>>. >>>> >>
>> >> >>> >>>> >>> >>>> >
>> > >>>> >>>
--replace-scene-breaks
>> >> >>> >>> >>>> >>>>>.
>>>>>, >> >>> >>> >>>>
>>>>>.
>> > >>
>>> >>>> >>> >>> >> >>>
>>>> >>>>>.
--search-replace
Path to a file containing search and replace regular
expressions. The file must contain alternating lines of regular
expression followed by replacement pattern (which can be an
empty line). The regular expression must be in the Python regex
syntax and the file must be UTF-8 encoded.
--sr1-replace
sr1-search> >> >>>> >>>> >>>
>>>>>.
--sr1-search
sr1-replace> >>> >> >>(>>>)>>>.
--sr2-replace
sr2-search> >> >>>> >>>> >>>
>>>>>.
--sr2-search
Search pattern (regular expression) to be replaced with
sr2-replace.
--sr3-replace
sr3-search> >> >>>> >>>> >>>
>>>>>.
--sr3-search
Search pattern (regular expression) to be replaced with
sr3-replace.
>> >>
>> >>> >> >>> >>>>>.
--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 is used by
screen readers for assisting the visually challenged.
--chapter
>(>)>>> >>>> >> XPath >>>.
>>>> "chapter", "book", "section", "prologue",
"epilogue", >> "part"> >>> > >>>>
>>>> >> >>> class="chapter"
>>> >>> >> >>>>>>. >>>
>>>> >>>> >>> >>> > >>>
>>>. > >>> >>>> >>> >>> "/">
>>>>>. > >> >>> >> > >>>
>>>> >>> >>> >>> >>>> XPath
>>>>> >>>>>.
--chapter-mark
>>> >> >>> >>> >>>>>.
"pagebreak" >> > >>> > >>> >>>>>.
"rule" >> > >>> >> >>>>>. "none"
>> > >>> >> >>, "both" >> > >>>
>> >> >>>>>.
--disable-remove-fake-margins
>> >>>> > >>> >>>> >> >
>>>> >> >> >>> >>>> >>>
>>>>. >>>> >>> >>> >>>>
>>>>> >>>>>. >> >>>>
>>>> >>>> >>> >>>> >>>
>>>>. >> >>>> > >>> >>>>
>>>.
--insert-metadata
>> >> >>> > >>>> >>>>>.
>>> >>> >>>> >>>>>
>>/>>>>> >>>> >> >>
>>>>>.
--page-breaks-before
XPath >>>. >>> >>> >> > >>>
>>>>>. >>>>>>> >> >>>>
>>>>>: /
--prefer-metadata-cover
>>> >>>> >>>>> >> >>>>
>>> >>> >>>>>.
--remove-first-image
>> >>>>>> >>> >>>>
>>>>>. >> >>> >> >>> >> >>
>>>> >>> >> >> >>>>>. >>
>>, > >>> >>>> >> >>>>
>>>>> >>> >>>>>> >> >>>
>>> >> >>>> >>> >>>>>>.
--start-reading-at
>>>>> >> >> >>> >>>> >>
XPath >>>. >> >>>>(>>>>> Kindle)>
>> > > > >>> >>>>>. > >>
>>> >>>>> >> > >> >>>>
>>> >>> >>>> XPath >>>>>
>>>>>.
>>
>>> >> >>> >>>>>. >>>>> >>
>>> >>> >> >>, >>>> >>> >>>
>> >>>>> >>>>>.
--duplicate-links-in-toc
>> >>> >>>> >>> >> >, >>
>>> >>>>>. >, >>> >>>> >>
>>> >> >>> >>>> >> > >>>
>>> >>>>>.
--level1-toc
>>> 1>>> >>>>>> >> >>>
>>>> XPath >>>. > >> >>>>>>>,
>> >>> >>>>> >>>>>. >>>
>>> >>> >>> >>> >> XPath
>>>>> >>>>>.
--level2-toc
>>> 2>>> >>>>>> >> >>>
>>>> XPath >>>. > >>> >>> 1>>
>> >>> >>>>>. >>> >>> >>>
>>> >>> >> XPath >>>>>
>>>>>.
--level3-toc
>>> 3>>> >>>>>> >> >>>
>>>> XPath >>>. > >>> >>> 2>>
>> >>> >>>>>. >>> >>> >>>
>>> >>> >> XPath >>>>>
>>>>>.
--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
Set the publication date (assumed to be in the local timezone,
unless the timezone is explicitly specified)
--publisher
>> >>>> >>>>>.
--rating
>>> >>>>>. 1> 5 >>> >>>>
>>>.
--read-metadata-from-opf, --from-opf, -m
>>> OPF >>>> >>>>>> >>>>>.
> >>>> >> >>>>>> >> >>>
>> >>>>>> >>>>>.
--series
> >> >>> > >>>> >>>>>.
--series-index
> >>>>> >> >>> >>>>>.
--tags >> >>> >>>>>. >>(,)> >>>
>>>>> >>>.
--timestamp
> >>>>> >>>>(> >> >>>>
>>>> >>)
--title
>>> >>>>>.
--title-sort
>>> >> >>> >>> >>>>>.
>>>
>> >>>> >>> >> >>
--debug-pipeline, -d
Save the output from different stages of the conversion pipeline
to the specified folder. Useful if you are unsure at which stage
of the conversion process a bug is occurring.
--verbose, -v
Level of verbosity. Specify multiple times for greater
verbosity. Specifying it twice will result in full verbosity,
once medium verbosity and zero times least verbosity.
AUTHOR
Kovid Goyal
COPYRIGHT
Kovid Goyal
7.17.0 8> 23, 2024 EBOOK-CONVERT(1)