Error handling Leave feedback
On this page
All conversion methods raise exceptions on failure. Use standard try/except with specific exception types:
from groupdocs.markdown import MarkdownConverter
from groupdocs.markdown import DocumentProtectedException, InvalidFormatException, GroupDocsMarkdownException
def error_handling_example():
"""Demonstrate error handling with specific exception types during conversion."""
try:
# Step 1: Attempt to convert the document
MarkdownConverter.to_file("annual-report.docx", "error-handling.md")
except DocumentProtectedException:
# Step 2a: Handle password-protected documents
print("Wrong or missing password.")
except InvalidFormatException:
# Step 2b: Handle corrupt or unsupported file formats
print("File is corrupt or unsupported.")
except GroupDocsMarkdownException as ex:
# Step 2c: Handle any other conversion errors
print(f"Conversion failed: {ex}")
if __name__ == "__main__":
error_handling_example()
annual-report.docx is sample file used in this example. Click here to download it.
Output produced by this example (download):
[queryEmployees]
Employee Information for Employee [EmployeeID]: [FirstName] [LastName]
Job Title
AUTOTEXTLIST \t "<wr:out select='${varName1.Title}'/>" [Title]
…
Output produced by this example (download):
[queryEmployees]
Employee Information for Employee [EmployeeID]: [FirstName] [LastName]
Job Title
AUTOTEXTLIST \t "<wr:out select=’${varName1.Title}’/>" [Title]
…
[queryEmployees]
Employee Information for Employee [EmployeeID]: [FirstName] [LastName]
# Employee Information
| Job Title | AUTOTEXTLIST \t "<wr:out select='${varName1.Title}'/>" [Title] |
| --- | --- |
...
[queryEmployees]
Employee Information for Employee [EmployeeID]: [FirstName] [LastName]
# Employee Information
| **Job Title** | **[Title]** |
| --- | --- |
[TRUNCATED]
| Exception | When raised |
|---|---|
DocumentProtectedException | Document is password-protected and no password or wrong password was provided |
InvalidFormatException | File is corrupt or has an unrecognized format |
GroupDocsMarkdownException | General conversion error |
Non-fatal issues are reported via ConvertResult.warnings:
from groupdocs.markdown import MarkdownConverter, ConvertOptions
def warnings_example():
"""Show how to inspect non-fatal conversion warnings after converting."""
# Step 1: Open the spreadsheet with a context manager
with MarkdownConverter("cost-analysis.xlsx") as converter:
# Step 2: Configure row truncation
options = ConvertOptions()
options.max_rows = 10 # limit to first 10 data rows per sheet
# Step 3: Convert using keyword argument for options
result = converter.convert("warnings.md", convert_options=options)
# Step 4: Inspect non-fatal warnings (e.g., truncation notices)
for warning in result.warnings:
print(f"Warning: {warning}")
if __name__ == "__main__":
warnings_example()
cost-analysis.xlsx is sample file used in this example. Click here to download it.
## Cost data and chart
| | | | | | | | |
| --- | --- | --- | --- | --- | --- | --- | --- |
| | | Cost Analysis | | | | | |
| | | PARETO CHART | | | | | |
| | | COST ANALYSIS | | | | | COST CENTER |
| | | Cost center | Annual cost | Percent of total | Cumulative percent | | |
| | | Parts and materials | $1,325,000.00 | 31.17% | 31.17% | | |
| | | Manufacturing equipment | $900,500.00 | 21.19% | 52.36% | | |
...
## Cost data and chart
| | | | | | | | |
| --- | --- | --- | --- | --- | --- | --- | --- |
| | | Cost Analysis | | | | | |
| | | PARETO CHART | | | | | |
| | | COST ANALYSIS | | | | | COST CENTER |
| | | Cost center | Annual cost | Percent of total | Cumulative percent | | |
| | | Parts and materials | $1,325,000.00 | 31.17% | 31.17% | | |
| | | Manufacturing equipment | $900,500.00 | 21.19% | 52.36% | | |
[TRUNCATED]
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.
