Skip to content

Commit cd0786a

Browse files
github-actions[bot]github-actions[bot]
committed
chore: sync markdown files from source repo
1 parent ac9e573 commit cd0786a

138 files changed

Lines changed: 4061 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎content/sites/groupdocs/markdown/english/_index.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,13 @@ Select your target platform below to access detailed API code documentation.
2727
alt="GroupDocs.Markdown for .NET Icon" style="width: 70px; height: 70px; object-fit: contain;">
2828
<h3 style="font-size: 16px; color: #333; margin: 10px 0; text-align: center;">GroupDocs.Markdown for .NET</h3>
2929
<p style="font-size: 12px; color: #666; text-align: center;">Access full API references for .NET developers</p>
30+
</a>
31+
<a href="/markdown/python-net/"
32+
style="width: 190px; height: 220px;background-color: #f7f7f7;border: 1px solid #ccc;border-radius: 8px;display: flex;flex-direction: column;align-items: center;justify-content: space-around;padding: 20px;box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);transition: transform 0.3s ease;text-decoration: none;color: inherit;">
33+
<img src="gdocs_python.png"
34+
alt="GroupDocs.Markdown Icon" style="width: 70px; height: 70px; object-fit: contain;">
35+
<h3 style="font-size: 16px; color: #333; margin: 10px 0; text-align: center;">GroupDocs.Markdown for Python via .NET</h3>
36+
<p style="font-size: 12px; color: #666; text-align: center;">GroupDocs.Markdown API for Python applications</p>
3037
</a>
3138
</div>
3239

‎content/sites/groupdocs/markdown/english/python-net/_index.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
title: groupdocs.markdown for Python via .NET
3+
second_title: GroupDocs.Markdown for Python via .NET API References
4+
description:
5+
type: docs
6+
url: /python-net/
7+
is_root: true
8+
weight: 10
9+
version: 26.3.0
10+
---
11+
12+
13+
### Modules
14+
| Module | Description |
15+
| :- | :- |
16+
| [`groupdocs.markdown`](/python-net/groupdocs.markdown/) | |

‎content/sites/groupdocs/markdown/english/python-net/groupdocs.markdown/_index.md‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: groupdocs.markdown
3+
second_title: GroupDocs.Markdown for Python via .NET API References
4+
description:
5+
type: docs
6+
url: /python-net/groupdocs.markdown/
7+
is_root: false
8+
weight: 10
9+
---
10+
11+
12+
### Classes
13+
| Class | Description |
14+
| :- | :- |
15+
| [`ConvertOptions`](/python-net/groupdocs.markdown/convertoptions/) | Provides options for customizing the document conversion process to Markdown format. |
16+
| [`ConvertResult`](/python-net/groupdocs.markdown/convertresult/) | Contains the output of a successful document-to-Markdown conversion. |
17+
| [`CustomImageSavingArgs`](/python-net/groupdocs.markdown/customimagesavingargs/) | Provides information and controls for saving a single image during document-to-Markdown conversion. |
18+
| [`CustomImagesStrategy`](/python-net/groupdocs.markdown/customimagesstrategy/) | Implements an image export strategy that gives you full control over how images are saved during conversion. |
19+
| [`CustomUriExportStrategy`](/python-net/groupdocs.markdown/customuriexportstrategy/) | Implements a URI export strategy that lets you customize how resource URIs are written to Markdown. |
20+
| [`DefaultUriExportStrategy`](/python-net/groupdocs.markdown/defaulturiexportstrategy/) | Provides default URI handling that keeps the URIs generated by the library unchanged. |
21+
| [`DocumentInfo`](/python-net/groupdocs.markdown/documentinfo/) | Provides read-only metadata about a loaded document, such as its format, page count, title, and encryption status. |
22+
| [`ExportImagesAsBase64Strategy`](/python-net/groupdocs.markdown/exportimagesasbase64strategy/) | Implements an image export strategy that embeds images as Base64 strings directly in the Markdown. |
23+
| [`ExportImagesToFileSystemStrategy`](/python-net/groupdocs.markdown/exportimagestofilesystemstrategy/) | Saves images to a folder on disk during conversion. |
24+
| [`ExportOptions`](/python-net/groupdocs.markdown/exportoptions/) | Options for exporting Markdown to a document format (reverse conversion). |
25+
| [`ImageExportContext`](/python-net/groupdocs.markdown/imageexportcontext/) | Contains read‑only information about a single image encountered during conversion and is passed to `IImageExportStrategy.get_image_stream(ImageExportContext)`. |
26+
| [`License`](/python-net/groupdocs.markdown/license/) | Manages GroupDocs.Markdown licensing. |
27+
| [`LoadOptions`](/python-net/groupdocs.markdown/loadoptions/) | Specifies additional options for loading a document, such as an explicit file format or a password for encrypted files. |
28+
| [`MarkdownConverter`](/python-net/groupdocs.markdown/markdownconverter/) | Converts documents from Word, Excel, PDF, and other formats to Markdown, offering static one-liner methods and an instance-based API with full control over conversion options. |
29+
| [`Metered`](/python-net/groupdocs.markdown/metered/) | Manages metered (pay-per-use) licensing. |
30+
| [`SkipImagesStrategy`](/python-net/groupdocs.markdown/skipimagesstrategy/) | Implements an image export strategy that skips saving images during document conversion. |
31+
| [`UriExportContext`](/python-net/groupdocs.markdown/uriexportcontext/) | Contains information about a resource URI being written during conversion. Passed to `IUriExportStrategy.update_resource_uri`. |
32+
| [`UriSavingArgs`](/python-net/groupdocs.markdown/urisavingargs/) | Provides information and controls for customizing how a resource URI is written during document-to-Markdown conversion. |
33+
34+
### Enumerations
35+
| Enum | Description |
36+
| :- | :- |
37+
| [`FileFormat`](/python-net/groupdocs.markdown/fileformat/) | Specifies a document file format. Used both as input format (when loading a document for conversion to Markdown) and as output format (when exporting Markdown to a document). |
38+
| [`MarkdownFlavor`](/python-net/groupdocs.markdown/markdownflavor/) | Specifies the target Markdown dialect for the conversion output. |
39+
40+
### Exceptions
41+
| Exception | Description |
42+
| :- | :- |
43+
| [`DocumentProtectedException`](/python-net/groupdocs.markdown/documentprotectedexception/) | The exception that is thrown when a document is password-protected and no password (or an incorrect password) was provided via [`LoadOptions.password`](/python-net/groupdocs.markdown/loadoptions/password/). |
44+
| [`GroupDocsMarkdownException`](/python-net/groupdocs.markdown/groupdocsmarkdownexception/) | Represents a product-specific exception that is thrown during file processing. |
45+
| [`InvalidFormatException`](/python-net/groupdocs.markdown/invalidformatexception/) | The exception that is thrown when a file has an invalid format. |

‎content/sites/groupdocs/markdown/english/python-net/groupdocs.markdown/convertoptions/__init__/_index.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
title: __init__ constructor
3+
second_title: GroupDocs.Markdown for Python via .NET API References
4+
description:
5+
type: docs
6+
url: /python-net/groupdocs.markdown/convertoptions/__init__/
7+
is_root: false
8+
weight: 10
9+
---
10+
11+
12+
## __init__
13+
14+
Initializes a new instance of the [`ConvertOptions`](/python-net/groupdocs.markdown/convertoptions/) class.
15+
16+
By default, [`ConvertOptions.image_export_strategy`](/python-net/groupdocs.markdown/convertoptions/image_export_strategy/) is set to [`ExportImagesAsBase64Strategy`](/python-net/groupdocs.markdown/exportimagesasbase64strategy/), which embeds images as Base64 strings directly in the Markdown output.
17+
18+
```python
19+
def __init__(self):
20+
...
21+
```
22+
23+
### See Also
24+
* class [`ConvertOptions`](/python-net/groupdocs.markdown/convertoptions/)

‎content/sites/groupdocs/markdown/english/python-net/groupdocs.markdown/convertoptions/_index.md‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
title: ConvertOptions class
3+
second_title: GroupDocs.Markdown for Python via .NET API References
4+
description:
5+
type: docs
6+
url: /python-net/groupdocs.markdown/convertoptions/
7+
is_root: false
8+
weight: 10
9+
---
10+
11+
12+
## ConvertOptions class
13+
14+
Provides options for customizing the document conversion process to Markdown format.
15+
16+
This class allows you to configure how documents are converted to Markdown, including how images are exported, how resource URIs are written, which pages to convert, and how heading levels are adjusted.
17+
18+
By default, images are embedded as Base64 strings in the Markdown output.
19+
20+
The ConvertOptions type exposes the following members:
21+
22+
### Constructors
23+
| Constructor | Description |
24+
| :- | :- |
25+
| [__init__](/python-net/groupdocs.markdown/convertoptions/__init__/) | Initializes a new instance of the [`ConvertOptions`](/python-net/groupdocs.markdown/convertoptions/) class. |
26+
27+
### Properties
28+
| Property | Description |
29+
| :- | :- |
30+
| [flavor](/python-net/groupdocs.markdown/convertoptions/flavor/) | The target Markdown dialect. |
31+
| [heading_level_offset](/python-net/groupdocs.markdown/convertoptions/heading_level_offset/) | The offset to apply to all heading levels in the Markdown output. |
32+
| [image_export_strategy](/python-net/groupdocs.markdown/convertoptions/image_export_strategy/) | The strategy for handling images during conversion. The default is [`ExportImagesAsBase64Strategy`](/python-net/groupdocs.markdown/exportimagesasbase64strategy/). |
33+
| [include_front_matter](/python-net/groupdocs.markdown/convertoptions/include_front_matter/) | The value indicating whether to prepend YAML front matter to the Markdown output. Default is False. |
34+
| [include_hidden_sheets](/python-net/groupdocs.markdown/convertoptions/include_hidden_sheets/) | The option indicating whether hidden worksheets are included in spreadsheet conversions. |
35+
| [max_columns](/python-net/groupdocs.markdown/convertoptions/max_columns/) | The maximum number of columns to include per table when converting spreadsheets. Columns beyond this limit are truncated with an ellipsis indicator. 0 means unlimited (default). |
36+
| [max_rows](/python-net/groupdocs.markdown/convertoptions/max_rows/) | The maximum number of data rows to include per worksheet when converting spreadsheets. |
37+
| [page_numbers](/python-net/groupdocs.markdown/convertoptions/page_numbers/) | The array of 1-based page or worksheet numbers to convert; set to None to convert all pages. |
38+
| [sheet_separator](/python-net/groupdocs.markdown/convertoptions/sheet_separator/) | The separator inserted between worksheets in spreadsheet conversions. |
39+
| [uri_export_strategy](/python-net/groupdocs.markdown/convertoptions/uri_export_strategy/) | The strategy for customizing resource URIs written to Markdown output. |
40+
41+
### See Also
42+
* module [`groupdocs.markdown`](/python-net/groupdocs.markdown/)

‎content/sites/groupdocs/markdown/english/python-net/groupdocs.markdown/convertoptions/flavor/_index.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: flavor property
3+
second_title: GroupDocs.Markdown for Python via .NET API References
4+
description:
5+
type: docs
6+
url: /python-net/groupdocs.markdown/convertoptions/flavor/
7+
is_root: false
8+
weight: 2010
9+
---
10+
11+
12+
## flavor property
13+
14+
The target Markdown dialect.
15+
16+
Default is [`MarkdownFlavor.git_hub`](/python-net/groupdocs.markdown/markdownflavor/git_hub/).
17+
18+
### Definition:
19+
```python
20+
@property
21+
def flavor(self):
22+
...
23+
@flavor.setter
24+
def flavor(self, value):
25+
...
26+
```
27+
28+
### See Also
29+
* class [`ConvertOptions`](/python-net/groupdocs.markdown/convertoptions/)

‎content/sites/groupdocs/markdown/english/python-net/groupdocs.markdown/convertoptions/heading_level_offset/_index.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title: heading_level_offset property
3+
second_title: GroupDocs.Markdown for Python via .NET API References
4+
description:
5+
type: docs
6+
url: /python-net/groupdocs.markdown/convertoptions/heading_level_offset/
7+
is_root: false
8+
weight: 2020
9+
---
10+
11+
12+
## heading_level_offset property
13+
14+
The offset to apply to all heading levels in the Markdown output.
15+
16+
A value of 2 turns `#` into `###`, `##` into `####`, etc. Heading levels are clamped to the range 1-6. Default is 0 (no change).
17+
18+
This is useful when you are embedding the converted Markdown inside a larger document where top-level headings are already in use. For example, setting this to 1 ensures the converted content starts at `##` instead of `#`.
19+
20+
### Definition:
21+
```python
22+
@property
23+
def heading_level_offset(self):
24+
...
25+
@heading_level_offset.setter
26+
def heading_level_offset(self, value):
27+
...
28+
```
29+
30+
### See Also
31+
* class [`ConvertOptions`](/python-net/groupdocs.markdown/convertoptions/)

‎content/sites/groupdocs/markdown/english/python-net/groupdocs.markdown/convertoptions/image_export_strategy/_index.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
title: image_export_strategy property
3+
second_title: GroupDocs.Markdown for Python via .NET API References
4+
description:
5+
type: docs
6+
url: /python-net/groupdocs.markdown/convertoptions/image_export_strategy/
7+
is_root: false
8+
weight: 2030
9+
---
10+
11+
12+
## image_export_strategy property
13+
14+
The strategy for handling images during conversion. The default is [`ExportImagesAsBase64Strategy`](/python-net/groupdocs.markdown/exportimagesasbase64strategy/).
15+
16+
Built-in strategies:
17+
- [`ExportImagesAsBase64Strategy`](/python-net/groupdocs.markdown/exportimagesasbase64strategy/) - Embeds images as Base64 strings (default)
18+
- [`ExportImagesToFileSystemStrategy`](/python-net/groupdocs.markdown/exportimagestofilesystemstrategy/) - Saves images to a specified folder
19+
- [`SkipImagesStrategy`](/python-net/groupdocs.markdown/skipimagesstrategy/) - Skips image saving
20+
- [`CustomImagesStrategy`](/python-net/groupdocs.markdown/customimagesstrategy/) - Custom image saving handler
21+
22+
Or implement `IImageExportStrategy` for a fully custom strategy.
23+
24+
### Definition:
25+
```python
26+
@property
27+
def image_export_strategy(self):
28+
...
29+
@image_export_strategy.setter
30+
def image_export_strategy(self, value):
31+
...
32+
```
33+
34+
### See Also
35+
* class [`ConvertOptions`](/python-net/groupdocs.markdown/convertoptions/)

‎content/sites/groupdocs/markdown/english/python-net/groupdocs.markdown/convertoptions/include_front_matter/_index.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: include_front_matter property
3+
second_title: GroupDocs.Markdown for Python via .NET API References
4+
description:
5+
type: docs
6+
url: /python-net/groupdocs.markdown/convertoptions/include_front_matter/
7+
is_root: false
8+
weight: 2040
9+
---
10+
11+
12+
## include_front_matter property
13+
14+
The value indicating whether to prepend YAML front matter to the Markdown output. Default is False.
15+
16+
Front matter is commonly used by static site generators such as Jekyll, Hugo, and Docusaurus. Only non-empty metadata fields are included.
17+
18+
### Definition:
19+
```python
20+
@property
21+
def include_front_matter(self):
22+
...
23+
@include_front_matter.setter
24+
def include_front_matter(self, value):
25+
...
26+
```
27+
28+
### See Also
29+
* class [`ConvertOptions`](/python-net/groupdocs.markdown/convertoptions/)

‎content/sites/groupdocs/markdown/english/python-net/groupdocs.markdown/convertoptions/include_hidden_sheets/_index.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: include_hidden_sheets property
3+
second_title: GroupDocs.Markdown for Python via .NET API References
4+
description:
5+
type: docs
6+
url: /python-net/groupdocs.markdown/convertoptions/include_hidden_sheets/
7+
is_root: false
8+
weight: 2050
9+
---
10+
11+
12+
## include_hidden_sheets property
13+
14+
The option indicating whether hidden worksheets are included in spreadsheet conversions.
15+
16+
Default is False.
17+
18+
### Definition:
19+
```python
20+
@property
21+
def include_hidden_sheets(self):
22+
...
23+
@include_hidden_sheets.setter
24+
def include_hidden_sheets(self, value):
25+
...
26+
```
27+
28+
### See Also
29+
* class [`ConvertOptions`](/python-net/groupdocs.markdown/convertoptions/)

0 commit comments

Comments
 (0)