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 E-book conversion

       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 LOOK AND FEEL

       o HEURISTIC PROCESSING

       o SEARCH AND REPLACE

       o STRUCTURE DETECTION

       o TABLE OF CONTENTS

       o METADATA

       o DEBUG

       --help, -h
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?>

       --input-profile
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?>
              <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?>. <?><?> <?><?><?><?><?><?>,
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> (<?>.<?>. <?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?>). <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?>: cybookg3, cybook_opus, default,
              hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle,
              msreader, mobipocket, nook, sony, sony300, sony900

       --list-recipes
              List builtin recipe names. You can create an e-book from a
              builtin recipe like this: ebook-convert "Recipe Name.recipe"
              output.epub

       --output-profile
              Specify the output profile. The output profile tells the
              conversion system how to optimize the created document for the
              specified device. In some cases, an output profile can be used
              to optimize the output for a particular device, but this is
              rarely necessary. Choices are:cybookg3, cybook_opus, default,
              generic_eink, generic_eink_hd, generic_eink_large, 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

       --version
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?>

<?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       mobi <?><?><?><?><?><?><?><?>

       --input-encoding
              <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?>. <?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>. <?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?>, <?><?><?> <?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>

<?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> epub

       --dont-split-on-page-breaks
              Turn off splitting at page breaks. Normally, input files are
              automatically split at every page break into two files. This
              gives an output e-book that can be parsed faster and with less
              resources. However, splitting is slow and if your source file
              contains a very large number of page breaks, you should turn off
              splitting on page breaks.

       --epub-flatten
              <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> EPUB <?><?><?><?><?><?> <?>
              FBReaderJ. <?><?><?> <?><?> "<?><?><?><?><?><?><?><?><?>"
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?> EPUBu <?>
              <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?>.

       --epub-inline-toc
              Insert an inline Table of Contents that will appear as part of
              the main book content.

       --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
              Put the inserted inline Table of Contents at the end of the book
              instead of the start.

       --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 <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> SVG
              <?><?><?><?><?><?>, <?><?><?> <?><?><?> <?><?> iPhone, <?><?><?>
              JetBook Lite. <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>.

       --preserve-cover-aspect-ratio
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?> SVG <?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>,
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?><?> <?>
              <?><?><?><?><?><?>). <?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?> <?><?><?><?>, <?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?>, <?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>. <?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?>, <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>.

       --pretty-print
              <?><?><?> <?><?> <?><?><?><?><?><?><?><?>, <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?>. <?><?><?> <?><?> <?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       --toc-title
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

LOOK AND FEEL
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>

       --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
              The base font size in pts. All font sizes in the produced book
              will be rescaled based on this size. By choosing a larger size
              you can make the fonts in the output bigger and vice versa. By
              default, when the value is zero, the base font size is chosen
              based on the output profile you chose.

       --change-justification
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?> "<?><?><?><?>"
              <?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> (<?><?>.
              <?><?><?><?><?><?><?><?><?><?>). <?><?><?><?><?><?><?><?>
              "<?><?><?><?><?><?><?><?>" <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?> <?>
              <?><?><?><?><?>. <?><?><?><?><?><?><?><?>
              "<?><?><?><?><?><?><?>" <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       --disable-font-rescaling
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       --embed-all-fonts
              Embed every font that is referenced in the input document but
              not already embedded. This will search your system for the
              fonts, and if found, they will be embedded. Embedding will only
              work if the format you are converting to supports embedded
              fonts, such as EPUB, AZW3, DOCX or PDF. Please ensure that you
              have the proper license for embedding the fonts used in this
              document.

       --embed-font-family
              Embed the specified font family into the book. This specifies
              the "base" font used for the book. If the input document
              specifies its own fonts, they may override this base font. You
              can use the filter style information option to remove fonts from
              the input document. Note that font embedding only works with
              some output formats, principally EPUB, AZW3 and 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
              A comma separated list of CSS properties that will be removed
              from all CSS style rules. This is useful if the presence of some
              style information prevents it from being overridden on your
              device. For example: 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
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              (<?><?><?><?><?><?><?><?><?> <p>, <?><?><?>
              <div><?><?><?><?><?><?>).

       --insert-blank-line-size
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> (<?> <?>m). <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?>.

       --keep-ligatures
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?><?>
              ff, fi, fl, <?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>. <?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              calibre <?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>.

       --line-height
              <?><?><?><?><?><?> <?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?>. <?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

       --linearize-tables
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>, <?> <?><?><?><?><?><?>
              <?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       --margin-bottom
              Set the bottom margin in pts. Default is 5.0. Setting this to
              less than zero will cause no margin to be set (the margin
              setting in the original document will be preserved). Note: Page
              oriented formats such as PDF and DOCX have their own margin
              settings that take precedence.

       --margin-left
              Set the left margin in pts. Default is 5.0. Setting this to less
              than zero will cause no margin to be set (the margin setting in
              the original document will be preserved). Note: Page oriented
              formats such as PDF and DOCX have their own margin settings that
              take precedence.

       --margin-right
              Set the right margin in pts. Default is 5.0. Setting this to
              less than zero will cause no margin to be set (the margin
              setting in the original document will be preserved). Note: Page
              oriented formats such as PDF and DOCX have their own margin
              settings that take precedence.

       --margin-top
              Set the top margin in pts. Default is 5.0. Setting this to less
              than zero will cause no margin to be set (the margin setting in
              the original document will be preserved). Note: Page oriented
              formats such as PDF and DOCX have their own margin settings that
              take precedence.

       --minimum-line-height
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>,
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?>. calibre <?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?>, <?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?>, <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>.
              <?><?> <?><?><?><?><?><?>, <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> 240.

       --remove-paragraph-spacing
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> 1.5em.
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> (<?><?><?><?><?><?><?><?><?> <p>, <?><?><?>
              <div><?><?><?><?><?><?>).

       --remove-paragraph-spacing-indent-size
              When calibre removes blank lines between paragraphs, it
              automatically sets a paragraph indent, to ensure that paragraphs
              can be easily distinguished. This option controls the width of
              that indent (in em). If you set this value negative, then the
              indent specified in the input document is used, that is, calibre
              does not change the indentation.

       --smarten-punctuation
              Convert plain quotes, dashes and ellipsis to their
              typographically correct equivalents. For details, see
              https://daringfireball.net/projects/smartypants.

       --subset-embedded-fonts
              Subset all embedded fonts. Every embedded font is reduced to
              contain only the glyphs used in this document. This decreases
              the size of the font files. Useful if you are embedding a
              particularly large font with lots of unused glyphs.

       --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
              Convert fancy quotes, dashes and ellipsis to their plain
              equivalents.

HEURISTIC PROCESSING
       Modify the document text and structure using common patterns. Disabled
       by default. Use --enable-heuristics to enable.  Individual actions can
       be disabled with the --disable-* options.

       --disable-dehyphenate
              Analyze hyphenated words throughout the document.  The document
              itself is used as a dictionary to determine whether hyphens
              should be retained or removed.

       --disable-delete-blank-paragraphs
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?>.

       --disable-fix-indents
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?> CSS
              <?><?><?><?><?><?><?><?>.

       --disable-format-scene-breaks
              Left aligned scene break markers are center aligned. Replace
              soft scene breaks that use multiple blank lines with horizontal
              rules.

       --disable-italicize-common-cases
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?> <?><?> <?> <?><?><?><?><?><?><?><?>.

       --disable-markup-chapter-headings
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?> <?>
              h1 <?> h2 <?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>, <?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.

       --disable-renumber-headings
              Looks for occurrences of sequential <h1> or <h2> tags. The tags
              are renumbered to prevent splitting in the middle of chapter
              headings.

       --disable-unwrap-lines
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>.

       --enable-heuristics
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       --html-unwrap-factor
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> 0
              <?><?> 1. <?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> 0,4, <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?>, <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>.

       --replace-scene-breaks
              Replace scene breaks with the specified text. By default, the
              text from the input document is used.

SEARCH AND REPLACE
       <?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>

       --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-<?><?><?><?><?><?><?><?><?>

       --sr1-search
              Search pattern (regular expression) to be replaced with
              sr1-replace.

       --sr2-replace
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?>  sr2-<?><?><?><?><?><?><?><?><?>

       --sr2-search
              Search pattern (regular expression) to be replaced with
              sr2-replace.

       --sr3-replace
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?>  sr3-<?><?><?><?><?><?><?><?><?>

       --sr3-search
              Search pattern (regular expression) to be replaced with
              sr3-replace.

STRUCTURE DETECTION
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       --chapter
              An XPath expression to detect chapter titles. The default is to
              consider <h1> or <h2> tags that contain the words "chapter",
              "book", "section", "prologue", "epilogue" or "part" as chapter
              titles as well as any tags that have class="chapter". The
              expression used must evaluate to a list of elements. To disable
              chapter detection, use the expression "/". See the XPath
              Tutorial in the calibre User Manual for further help on using
              this feature.

       --chapter-mark
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?> "pagebreak"
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?> "rule" <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?> "none" <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>, <?> <?><?><?><?><?><?><?><?> "both"
              <?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?> <?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       --disable-remove-fake-margins
              Some documents specify page margins by specifying a left and
              right margin on each individual paragraph. calibre will try to
              detect and remove these margins. Sometimes, this can cause the
              removal of margins that should not have been removed. In this
              case you can disable the removal.

       --insert-metadata
              Insert the book metadata at the start of the book. This is
              useful if your e-book reader does not support
              displaying/searching metadata directly.

       --page-breaks-before
              An XPath expression. Page breaks are inserted before the
              specified elements. To disable use the expression: /

       --prefer-metadata-cover
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       --remove-first-image
              Remove the first image from the input e-book. Useful if the
              input document has a cover image that is not identified as a
              cover. In this case, if you set a cover in calibre, the output
              document will end up with two cover images if you do not specify
              this option.

       --start-reading-at
              An XPath expression to detect the location in the document at
              which to start reading. Some e-book reading programs (most
              prominently the Kindle) use this location as the position at
              which to open the book. See the XPath tutorial in the calibre
              User Manual for further help using this feature.

TABLE OF CONTENTS
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>, <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?>, <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.

       --duplicate-links-in-toc
              When creating a TOC from links in the input document, allow
              duplicate entries, i.e. allow more than one entry with the same
              text, provided that they point to a different location.

       --level1-toc
              XPath expression that specifies all tags that should be added to
              the Table of Contents at level one. If this is specified, it
              takes precedence over other forms of auto-detection. See the
              XPath Tutorial in the calibre User Manual for examples.

       --level2-toc
              XPath expression that specifies all tags that should be added to
              the Table of Contents at level two. Each entry is added under
              the previous level one entry. See the XPath Tutorial in the
              calibre User Manual for examples.

       --level3-toc
              XPath expression that specifies all tags that should be added to
              the Table of Contents at level three. Each entry is added under
              the previous level two entry. See the XPath Tutorial in the
              calibre User Manual for examples.

       --max-toc-links
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?> 0 <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?><?><?>
              <?><?>: 50. <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?>.

       --no-chapters-in-toc
              <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?>.

       --toc-filter
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>, <?><?><?>
              <?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?><?>.

       --toc-threshold
              <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>, <?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?><?><?> <?><?>:
              6

       --use-auto-toc
              <?><?><?><?><?><?>, <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?><?>, <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

METADATA
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>

       --author-sort
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.

       --authors
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?> <?><?> <?><?><?> <?><?><?><?>, <?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>.

       --book-producer
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?>.

       --comments
              Set the e-book description.

       --cover
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>, <?><?><?>
              <?><?><?>

       --isbn <?><?><?><?><?><?> ISBN <?><?><?><?> <?><?><?><?><?>.

       --language
              <?><?><?><?><?><?> <?><?><?><?><?>

       --pubdate
              Set the publication date (assumed to be in the local timezone,
              unless the timezone is explicitly specified)

       --publisher
              Set the e-book publisher.

       --rating
              <?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?>, <?><?><?><?><?><?> 1 <?>
              5.

       --read-metadata-from-opf, --from-opf, -m
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?> OPF <?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       --series
              Set the series this e-book belongs to.

       --series-index
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?>
              <?><?><?><?><?><?>.

       --tags <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>.

       --timestamp
              Set the book timestamp (no longer used anywhere)

       --title
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       --title-sort
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?>

DEBUG
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?>

       --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.10.0                        <?><?><?> 03, 2024              EBOOK-CONVERT(1)