markitdown-gc 0.2.0__tar.gz → 0.3.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/.gitignore +171 -171
  2. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/LICENSE +21 -21
  3. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/PKG-INFO +14 -4
  4. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/README.md +60 -60
  5. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/ThirdPartyNotices.md +231 -231
  6. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/pyproject.toml +139 -126
  7. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/GUIDE.md +93 -93
  8. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/__about__.py +4 -4
  9. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/__init__.py +34 -34
  10. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/__main__.py +485 -439
  11. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/_base_converter.py +109 -109
  12. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/_exceptions.py +82 -82
  13. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/_hwp_media.py +132 -132
  14. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/_markitdown.py +873 -861
  15. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/_media.py +67 -67
  16. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/_stream_info.py +32 -32
  17. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/_uri_utils.py +75 -75
  18. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converter_utils/_image.py +19 -19
  19. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converter_utils/_xlsx_images.py +114 -114
  20. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converter_utils/docx/_images.py +118 -118
  21. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converter_utils/docx/math/latex_dict.py +291 -291
  22. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converter_utils/docx/math/omml.py +417 -417
  23. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converter_utils/docx/pre_process.py +290 -290
  24. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/__init__.py +56 -56
  25. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_audio_converter.py +106 -106
  26. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_bing_serp_converter.py +120 -120
  27. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_csv_converter.py +133 -133
  28. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_cu_converter.py +570 -570
  29. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_doc_intel_converter.py +479 -258
  30. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_docx_converter.py +163 -163
  31. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_epub_converter.py +185 -185
  32. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_exiftool.py +57 -57
  33. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_html_converter.py +112 -112
  34. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_hwp_converter.py +105 -105
  35. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_image_converter.py +139 -139
  36. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_ipynb_converter.py +103 -103
  37. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_llm_caption.py +50 -50
  38. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_markdownify.py +178 -178
  39. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_outlook_msg_converter.py +349 -349
  40. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_pdf_converter.py +593 -593
  41. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_plain_text_converter.py +66 -66
  42. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_pptx_converter.py +387 -387
  43. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_rss_converter.py +488 -488
  44. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_transcribe_audio.py +60 -60
  45. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_wikipedia_converter.py +99 -99
  46. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_xlsx_converter.py +279 -279
  47. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_youtube_converter.py +256 -256
  48. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converters/_zip_converter.py +130 -130
  49. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/ocr_triage.py +943 -943
  50. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converter_utils/__init__.py +0 -0
  51. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converter_utils/docx/__init__.py +0 -0
  52. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/converter_utils/docx/math/__init__.py +0 -0
  53. {markitdown_gc-0.2.0 → markitdown_gc-0.3.0}/src/markitdown/py.typed +0 -0
@@ -1,171 +1,171 @@
1
- .vscode
2
-
3
- # Byte-compiled / optimized / DLL files
4
- __pycache__/
5
- *.py[cod]
6
- *$py.class
7
-
8
- # C extensions
9
- *.so
10
-
11
- # Distribution / packaging
12
- .Python
13
- build/
14
- develop-eggs/
15
- dist/
16
- downloads/
17
- eggs/
18
- .eggs/
19
- lib/
20
- lib64/
21
- parts/
22
- sdist/
23
- var/
24
- wheels/
25
- share/python-wheels/
26
- *.egg-info/
27
- .installed.cfg
28
- *.egg
29
- MANIFEST
30
-
31
- # PyInstaller
32
- # Usually these files are written by a python script from a template
33
- # before PyInstaller builds the exe, so as to inject date/other infos into it.
34
- *.manifest
35
- *.spec
36
-
37
- # Installer logs
38
- pip-log.txt
39
- pip-delete-this-directory.txt
40
-
41
- # Unit test / coverage reports
42
- htmlcov/
43
- .tox/
44
- .nox/
45
- .coverage
46
- .coverage.*
47
- .cache
48
- nosetests.xml
49
- coverage.xml
50
- *.cover
51
- *.py,cover
52
- .hypothesis/
53
- .pytest_cache/
54
- cover/
55
- .test-logs/
56
-
57
- # Translations
58
- *.mo
59
- *.pot
60
-
61
- # Django stuff:
62
- *.log
63
- local_settings.py
64
- db.sqlite3
65
- db.sqlite3-journal
66
-
67
- # Flask stuff:
68
- instance/
69
- .webassets-cache
70
-
71
- # Scrapy stuff:
72
- .scrapy
73
-
74
- # Sphinx documentation
75
- docs/_build/
76
-
77
- # PyBuilder
78
- .pybuilder/
79
- target/
80
-
81
- # Jupyter Notebook
82
- .ipynb_checkpoints
83
-
84
- # IPython
85
- profile_default/
86
- ipython_config.py
87
-
88
- # pyenv
89
- # For a library or package, you might want to ignore these files since the code is
90
- # intended to run in multiple environments; otherwise, check them in:
91
- # .python-version
92
-
93
- # pipenv
94
- # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
95
- # However, in case of collaboration, if having platform-specific dependencies or dependencies
96
- # having no cross-platform support, pipenv may install dependencies that don't work, or not
97
- # install all needed dependencies.
98
- #Pipfile.lock
99
-
100
- # poetry
101
- # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
102
- # This is especially recommended for binary packages to ensure reproducibility, and is more
103
- # commonly ignored for libraries.
104
- # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
105
- #poetry.lock
106
-
107
- # pdm
108
- # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
109
- #pdm.lock
110
- # pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
111
- # in version control.
112
- # https://pdm.fming.dev/latest/usage/project/#working-with-version-control
113
- .pdm.toml
114
- .pdm-python
115
- .pdm-build/
116
-
117
- # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
118
- __pypackages__/
119
-
120
- # Celery stuff
121
- celerybeat-schedule
122
- celerybeat.pid
123
-
124
- # SageMath parsed files
125
- *.sage.py
126
-
127
- # Environments
128
- .env
129
- .venv
130
- env/
131
- venv/
132
- ENV/
133
- env.bak/
134
- venv.bak/
135
-
136
- # Spyder project settings
137
- .spyderproject
138
- .spyproject
139
-
140
- # Rope project settings
141
- .ropeproject
142
-
143
- # mkdocs documentation
144
- /site
145
-
146
- # mypy
147
- .mypy_cache/
148
- .dmypy.json
149
- dmypy.json
150
-
151
- # Pyre type checker
152
- .pyre/
153
-
154
- # pytype static type analyzer
155
- .pytype/
156
-
157
- # Cython debug symbols
158
- cython_debug/
159
-
160
- # PyCharm
161
- # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
162
- # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
163
- # and can be added to the global gitignore or merged into this file. For a more nuclear
164
- # option (not recommended) you can uncomment the following to ignore the entire idea folder.
165
- #.idea/
166
- src/.DS_Store
167
- .DS_Store
168
- .cursorrules
169
-
170
- # OCR triage work files (may contain document content)
171
- ocr-work/
1
+ .vscode
2
+
3
+ # Byte-compiled / optimized / DLL files
4
+ __pycache__/
5
+ *.py[cod]
6
+ *$py.class
7
+
8
+ # C extensions
9
+ *.so
10
+
11
+ # Distribution / packaging
12
+ .Python
13
+ build/
14
+ develop-eggs/
15
+ dist/
16
+ downloads/
17
+ eggs/
18
+ .eggs/
19
+ lib/
20
+ lib64/
21
+ parts/
22
+ sdist/
23
+ var/
24
+ wheels/
25
+ share/python-wheels/
26
+ *.egg-info/
27
+ .installed.cfg
28
+ *.egg
29
+ MANIFEST
30
+
31
+ # PyInstaller
32
+ # Usually these files are written by a python script from a template
33
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
34
+ *.manifest
35
+ *.spec
36
+
37
+ # Installer logs
38
+ pip-log.txt
39
+ pip-delete-this-directory.txt
40
+
41
+ # Unit test / coverage reports
42
+ htmlcov/
43
+ .tox/
44
+ .nox/
45
+ .coverage
46
+ .coverage.*
47
+ .cache
48
+ nosetests.xml
49
+ coverage.xml
50
+ *.cover
51
+ *.py,cover
52
+ .hypothesis/
53
+ .pytest_cache/
54
+ cover/
55
+ .test-logs/
56
+
57
+ # Translations
58
+ *.mo
59
+ *.pot
60
+
61
+ # Django stuff:
62
+ *.log
63
+ local_settings.py
64
+ db.sqlite3
65
+ db.sqlite3-journal
66
+
67
+ # Flask stuff:
68
+ instance/
69
+ .webassets-cache
70
+
71
+ # Scrapy stuff:
72
+ .scrapy
73
+
74
+ # Sphinx documentation
75
+ docs/_build/
76
+
77
+ # PyBuilder
78
+ .pybuilder/
79
+ target/
80
+
81
+ # Jupyter Notebook
82
+ .ipynb_checkpoints
83
+
84
+ # IPython
85
+ profile_default/
86
+ ipython_config.py
87
+
88
+ # pyenv
89
+ # For a library or package, you might want to ignore these files since the code is
90
+ # intended to run in multiple environments; otherwise, check them in:
91
+ # .python-version
92
+
93
+ # pipenv
94
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
95
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
96
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
97
+ # install all needed dependencies.
98
+ #Pipfile.lock
99
+
100
+ # poetry
101
+ # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
102
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
103
+ # commonly ignored for libraries.
104
+ # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
105
+ #poetry.lock
106
+
107
+ # pdm
108
+ # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
109
+ #pdm.lock
110
+ # pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
111
+ # in version control.
112
+ # https://pdm.fming.dev/latest/usage/project/#working-with-version-control
113
+ .pdm.toml
114
+ .pdm-python
115
+ .pdm-build/
116
+
117
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
118
+ __pypackages__/
119
+
120
+ # Celery stuff
121
+ celerybeat-schedule
122
+ celerybeat.pid
123
+
124
+ # SageMath parsed files
125
+ *.sage.py
126
+
127
+ # Environments
128
+ .env
129
+ .venv
130
+ env/
131
+ venv/
132
+ ENV/
133
+ env.bak/
134
+ venv.bak/
135
+
136
+ # Spyder project settings
137
+ .spyderproject
138
+ .spyproject
139
+
140
+ # Rope project settings
141
+ .ropeproject
142
+
143
+ # mkdocs documentation
144
+ /site
145
+
146
+ # mypy
147
+ .mypy_cache/
148
+ .dmypy.json
149
+ dmypy.json
150
+
151
+ # Pyre type checker
152
+ .pyre/
153
+
154
+ # pytype static type analyzer
155
+ .pytype/
156
+
157
+ # Cython debug symbols
158
+ cython_debug/
159
+
160
+ # PyCharm
161
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
162
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
163
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
164
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
165
+ #.idea/
166
+ src/.DS_Store
167
+ .DS_Store
168
+ .cursorrules
169
+
170
+ # OCR triage work files (may contain document content)
171
+ ocr-work/
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) Microsoft Corporation.
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE
1
+ MIT License
2
+
3
+ Copyright (c) Microsoft Corporation.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: markitdown-gc
3
- Version: 0.2.0
3
+ Version: 0.3.0
4
4
  Summary: Utility tool for converting various files to Markdown
5
5
  Project-URL: Documentation, https://github.com/greatgc-flow/markitdown#readme
6
6
  Project-URL: Issues, https://github.com/greatgc-flow/markitdown/issues
@@ -24,9 +24,19 @@ Requires-Dist: beautifulsoup4
24
24
  Requires-Dist: certifi>=2026.10.19
25
25
  Requires-Dist: charset-normalizer
26
26
  Requires-Dist: defusedxml
27
+ Requires-Dist: hwp-hwpx-parser<1.1,>=1.0
28
+ Requires-Dist: lxml
27
29
  Requires-Dist: magika<2,>=0.6.1; python_full_version < '3.15'
30
+ Requires-Dist: mammoth<2,>=1.12.2
28
31
  Requires-Dist: markdownify
32
+ Requires-Dist: olefile
33
+ Requires-Dist: openpyxl
34
+ Requires-Dist: pandas
35
+ Requires-Dist: pdfminer-six>=20251230
36
+ Requires-Dist: pdfplumber>=0.11.9
37
+ Requires-Dist: python-pptx
29
38
  Requires-Dist: requests
39
+ Requires-Dist: xlrd
30
40
  Provides-Extra: all
31
41
  Requires-Dist: azure-ai-contentunderstanding>=1.2.0b1; extra == 'all'
32
42
  Requires-Dist: azure-ai-documentintelligence; extra == 'all'
@@ -93,10 +103,10 @@ Description-Content-Type: text/markdown
93
103
  From PyPI:
94
104
 
95
105
  ```bash
96
- pip install 'markitdown-gc[all]'
106
+ pip install markitdown-gc
97
107
  ```
98
108
 
99
- HWP5/HWPX support is included in `[all]` or installed separately with `pip install 'markitdown-gc[hwp]'`. The backend is pure Python for all platforms. Tables use pipe rows (merged cells lose their spans), images become `[IMAGE]` placeholders, and note bodies are included. HWP < 5, encrypted/distribution documents, headers/footers, and exact layout are unsupported. See the project [HWP/HWPX documentation](https://github.com/greatgc-flow/markitdown#hwphwpx) for details.
109
+ All document converters (PDF, DOCX, PPTX, XLSX/XLS, Outlook, HWP5/HWPX) are included in the default install; `markitdown-gc --guide` explains usage. Audio, YouTube and Azure support stay optional (`[all]` adds them). The backend is pure Python for all platforms. Tables use pipe rows (merged cells lose their spans), images become `[IMAGE]` placeholders, and note bodies are included. HWP < 5, encrypted/distribution documents, headers/footers, and exact layout are unsupported. See the project [HWP/HWPX documentation](https://github.com/greatgc-flow/markitdown#hwphwpx) for details.
100
110
 
101
111
  From source:
102
112
 
@@ -111,7 +121,7 @@ pip install -e 'packages/markitdown[all]'
111
121
  ### Command-Line
112
122
 
113
123
  ```bash
114
- markitdown path-to-file.pdf > document.md
124
+ markitdown-gc path-to-file.pdf > document.md
115
125
  ```
116
126
 
117
127
  ### Python API
@@ -1,60 +1,60 @@
1
- # MarkItDown GC
2
-
3
- > Unofficial fork of [Microsoft MarkItDown](https://github.com/microsoft/markitdown), maintained at [greatgc-flow/markitdown](https://github.com/greatgc-flow/markitdown). This fork is not affiliated with or endorsed by Microsoft.
4
- > Install the `markitdown-gc` distribution. Do not install it together with upstream `markitdown` in the same environment: both provide the `markitdown` import and CLI, and the same plugin group. Use a fresh virtual environment.
5
-
6
- > [!TIP]
7
- > MarkItDown is a Python package and command-line utility for converting various files to Markdown (e.g., for indexing, text analysis, etc).
8
- >
9
- > For more information, and full documentation, see the project [README.md](https://github.com/greatgc-flow/markitdown) on GitHub.
10
-
11
- > [!IMPORTANT]
12
- > MarkItDown performs I/O with the privileges of the current process. Like open() or requests.get(), it will access resources that the process itself can access. Sanitize your inputs in untrusted environments, and call the narrowest `convert_*` function needed for your use case (e.g., `convert_stream()`, or `convert_local()`). See the [Security Considerations](https://github.com/greatgc-flow/markitdown#security-considerations) section of the documentation for more information.
13
-
14
- ## Installation
15
-
16
- From PyPI:
17
-
18
- ```bash
19
- pip install 'markitdown-gc[all]'
20
- ```
21
-
22
- HWP5/HWPX support is included in `[all]` or installed separately with `pip install 'markitdown-gc[hwp]'`. The backend is pure Python for all platforms. Tables use pipe rows (merged cells lose their spans), images become `[IMAGE]` placeholders, and note bodies are included. HWP < 5, encrypted/distribution documents, headers/footers, and exact layout are unsupported. See the project [HWP/HWPX documentation](https://github.com/greatgc-flow/markitdown#hwphwpx) for details.
23
-
24
- From source:
25
-
26
- ```bash
27
- git clone https://github.com/greatgc-flow/markitdown.git
28
- cd markitdown
29
- pip install -e 'packages/markitdown[all]'
30
- ```
31
-
32
- ## Usage
33
-
34
- ### Command-Line
35
-
36
- ```bash
37
- markitdown path-to-file.pdf > document.md
38
- ```
39
-
40
- ### Python API
41
-
42
- ```python
43
- from markitdown import MarkItDown
44
-
45
- md = MarkItDown()
46
- result = md.convert("test.xlsx")
47
- print(result.markdown)
48
- ```
49
-
50
- ### More Information
51
-
52
- For more information, and full documentation, see the project [README.md](https://github.com/greatgc-flow/markitdown) on GitHub.
53
-
54
- ## Trademarks
55
-
56
- This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
57
- trademarks or logos is subject to and must follow
58
- [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
59
- Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
60
- Any use of third-party trademarks or logos are subject to those third-party's policies.
1
+ # MarkItDown GC
2
+
3
+ > Unofficial fork of [Microsoft MarkItDown](https://github.com/microsoft/markitdown), maintained at [greatgc-flow/markitdown](https://github.com/greatgc-flow/markitdown). This fork is not affiliated with or endorsed by Microsoft.
4
+ > Install the `markitdown-gc` distribution. Do not install it together with upstream `markitdown` in the same environment: both provide the `markitdown` import and CLI, and the same plugin group. Use a fresh virtual environment.
5
+
6
+ > [!TIP]
7
+ > MarkItDown is a Python package and command-line utility for converting various files to Markdown (e.g., for indexing, text analysis, etc).
8
+ >
9
+ > For more information, and full documentation, see the project [README.md](https://github.com/greatgc-flow/markitdown) on GitHub.
10
+
11
+ > [!IMPORTANT]
12
+ > MarkItDown performs I/O with the privileges of the current process. Like open() or requests.get(), it will access resources that the process itself can access. Sanitize your inputs in untrusted environments, and call the narrowest `convert_*` function needed for your use case (e.g., `convert_stream()`, or `convert_local()`). See the [Security Considerations](https://github.com/greatgc-flow/markitdown#security-considerations) section of the documentation for more information.
13
+
14
+ ## Installation
15
+
16
+ From PyPI:
17
+
18
+ ```bash
19
+ pip install markitdown-gc
20
+ ```
21
+
22
+ All document converters (PDF, DOCX, PPTX, XLSX/XLS, Outlook, HWP5/HWPX) are included in the default install; `markitdown-gc --guide` explains usage. Audio, YouTube and Azure support stay optional (`[all]` adds them). The backend is pure Python for all platforms. Tables use pipe rows (merged cells lose their spans), images become `[IMAGE]` placeholders, and note bodies are included. HWP < 5, encrypted/distribution documents, headers/footers, and exact layout are unsupported. See the project [HWP/HWPX documentation](https://github.com/greatgc-flow/markitdown#hwphwpx) for details.
23
+
24
+ From source:
25
+
26
+ ```bash
27
+ git clone https://github.com/greatgc-flow/markitdown.git
28
+ cd markitdown
29
+ pip install -e 'packages/markitdown[all]'
30
+ ```
31
+
32
+ ## Usage
33
+
34
+ ### Command-Line
35
+
36
+ ```bash
37
+ markitdown-gc path-to-file.pdf > document.md
38
+ ```
39
+
40
+ ### Python API
41
+
42
+ ```python
43
+ from markitdown import MarkItDown
44
+
45
+ md = MarkItDown()
46
+ result = md.convert("test.xlsx")
47
+ print(result.markdown)
48
+ ```
49
+
50
+ ### More Information
51
+
52
+ For more information, and full documentation, see the project [README.md](https://github.com/greatgc-flow/markitdown) on GitHub.
53
+
54
+ ## Trademarks
55
+
56
+ This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
57
+ trademarks or logos is subject to and must follow
58
+ [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
59
+ Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
60
+ Any use of third-party trademarks or logos are subject to those third-party's policies.