Convert to eBook with advanced options
Leave feedback
On this page
GroupDocs.Conversion provides EBookConvertOptions to give you control over conversion result when converting to eBook formats. Along with common convert options from the base class, EBookConvertOptions provides the following additional options:
| Property | Type | Description |
|---|---|---|
| Format | EBookFileType | Specifies the desired eBook format. Available options are: Epub, Mobi, Azw3 |
| PageSize | PageSize | Sets the page size for the converted eBook |
| PageWidth | double | Sets custom page width in points |
| PageHeight | double | Sets custom page height in points |
| PageOrientation | PageOrientation | Sets page orientation (Portrait or Landscape) |
| FallbackPageSize | PageSize | Sets fallback page size when source page dimensions cannot be determined |
| PageNumber | int | Specifies the starting page number for conversion |
| PagesCount | int | Specifies the number of pages to convert |
| Pages | List<int> | Specifies specific page numbers to convert |
Convert any document to EPUB format with default options:
using (var converter = new Converter("document.pdf"))
{
var options = new EBookConvertOptions();
converter.Convert("document.epub", options);
}
Convert documents to EPUB, MOBI, or AZW3 formats by specifying the desired format:
using (var converter = new Converter("document.pdf"))
{
var options = new EBookConvertOptions
{
Format = EBookFileType.Epub
};
converter.Convert("output.epub", options);
}
using (var converter = new Converter("document.docx"))
{
var options = new EBookConvertOptions
{
Format = EBookFileType.Mobi
};
converter.Convert("output.mobi", options);
}
using (var converter = new Converter("presentation.pptx"))
{
var options = new EBookConvertOptions
{
Format = EBookFileType.Azw3
};
converter.Convert("output.azw3", options);
}
Set the page orientation for the converted eBook:
using (var converter = new Converter("landscape-document.pdf"))
{
var options = new EBookConvertOptions
{
PageOrientation = PageOrientation.Landscape
};
converter.Convert("landscape-ebook.epub", options);
}
Specify custom page width and height in points for precise control:
using (var converter = new Converter("document.pdf"))
{
var options = new EBookConvertOptions
{
PageWidth = 432, // Width in points (6 inches × 72 points/inch)
PageHeight = 648 // Height in points (9 inches × 72 points/inch)
};
converter.Convert("custom-size.epub", options);
}
Convert only selected pages from the source document:
using (var converter = new Converter("multi-page.pdf"))
{
var options = new EBookConvertOptions
{
PageNumber = 1,
PagesCount = 1
};
converter.Convert("first-page.epub", options);
}
using (var converter = new Converter("report.pdf"))
{
var options = new EBookConvertOptions
{
PageNumber = 2, // Start from page 2
PagesCount = 5 // Convert 5 pages (pages 2-6)
};
converter.Convert("selected-pages.epub", options);
}
You can convert the following document types to eBook formats:
- Documents: PDF, DOC, DOCX, RTF, ODT, TXT
- Presentations: PPT, PPTX, ODP
- Spreadsheets: XLS, XLSX, ODS, CSV
- Web: HTML, MHTML, HTM
- Images: JPG, PNG, TIFF, BMP (single or multi-page)
- eBooks: Convert between EPUB, MOBI, and AZW3 formats
EPUB is the most widely supported eBook format, compatible with:
- Apple Books (iOS, macOS)
- Google Play Books
- Adobe Digital Editions
- Most e-readers (except Amazon Kindle)
Use Cases:
- General-purpose eBook distribution
- Publishing for non-Kindle devices
- Academic and technical documentation
- Digital magazines and newspapers
MOBI is Amazon’s legacy eBook format, supported by:
- Older Kindle devices
- Kindle apps (with limitations)
Use Cases:
- Legacy Kindle device support
- Older eBook reader compatibility
Note: For modern Kindle devices, use AZW3 instead.
AZW3 is Amazon’s modern eBook format with enhanced features:
- Better typography and formatting
- Fixed layout support
- Enhanced image handling
- Kindle-exclusive features
Use Cases:
- Publishing to Amazon Kindle Store
- Kindle device optimization
- Enhanced formatting requirements
Convert manuscripts and documents to eBook format for digital distribution:
using (var converter = new Converter("manuscript.docx"))
{
var options = new EBookConvertOptions
{
Format = EBookFileType.Epub,
PageOrientation = PageOrientation.Portrait
};
converter.Convert("published-book.epub", options);
}
Create eBook versions of technical manuals and documentation:
using (var converter = new Converter("user-manual.pdf"))
{
var options = new EBookConvertOptions
{
Format = EBookFileType.Mobi,
PageWidth = 432, // 6 inches × 72 points/inch
PageHeight = 648 // 9 inches × 72 points/inch
};
converter.Convert("user-manual.mobi", options);
}
Convert business reports to portable eBook format:
using (var converter = new Converter("quarterly-report.xlsx"))
{
var options = new EBookConvertOptions
{
Format = EBookFileType.Epub,
PageOrientation = PageOrientation.Landscape
};
converter.Convert("quarterly-report.epub", options);
}
Transform educational content into readable eBook format:
using (var converter = new Converter("lecture-slides.pptx"))
{
var options = new EBookConvertOptions
{
Format = EBookFileType.Azw3,
PageNumber = 1,
PagesCount = 50
};
converter.Convert("course-material.azw3", options);
}
Use EBookConvertOptions when you need to:
- Publish content for e-readers and mobile reading apps
- Create portable versions of documents optimized for reading devices
- Distribute documentation in universally accessible eBook formats
- Convert between eBook formats (EPUB to MOBI, etc.)
- Customize page layout for specific e-reader dimensions
- Extract portions of documents as standalone eBooks
- Optimize reading experience with proper orientation and sizing
Choose the right format:
- Use EPUB for maximum compatibility
- Use MOBI for legacy Kindle support
- Use AZW3 for modern Kindle devices
Set appropriate page dimensions:
- Standard eBook (6"×9"): 432×648 points
- Tablet readers (8"×10.67"): 576×768 points
- Custom dimensions for specific devices (1 point = 1/72 inch)
Consider orientation:
- Portrait for text-heavy content
- Landscape for image-heavy or technical content
Optimize source documents:
- Use clear heading structures
- Ensure proper table of contents
- Optimize images for eBook display
EBookConvertOptions provides comprehensive control over eBook conversions:
- Three formats: EPUB, MOBI, and AZW3 support
- Page customization: Control size, orientation, and dimensions
- Selective conversion: Convert specific pages or page ranges
- Wide compatibility: Convert from numerous source formats
- Reading optimization: Tailor output for specific devices and use cases
All examples on this page have been verified through automated testing to ensure accuracy.
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.