Sample data and code for the article on MarkItDown (#707)

* Sample data and code for the article on MarkItDown

* Fake commit

* Revert

* Trigger CI after workflow removal

* TR updates, second round

* Remove unused imports

* Final QA

* Reformat code

---------

Co-authored-by: Bartosz Zaczyński <[email protected]>

Author: lpozo

python-markitdown/README.md

@@ -0,0 +1,3 @@
+# Python MarkItDown: Convert Documents Into LLM-Ready Markdown
+
+This folder provides the code examples for the Real Python tutorial [Python MarkItDown: Convert Documents Into LLM-Ready Markdown](https://realpython.com/python-markitdown/).

python-markitdown/batch_converter.py

@@ -0,0 +1,33 @@
+from pathlib import Path
+
+from markitdown import MarkItDown
+
+
+def main(
+    input_dir,
+    output_dir="output",
+    target_formats=(".docx", ".xlsx", ".pdf"),
+):
+    input_path = Path(input_dir)
+    output_path = Path(output_dir)
+    output_path.mkdir(parents=True, exist_ok=True)
+
+    md = MarkItDown()
+
+    for file_path in input_path.rglob("*"):
+        if file_path.suffix in target_formats:
+            try:
+                result = md.convert(file_path)
+            except Exception as e:
+                print(f"✗ Error converting {file_path.name}: {e}")
+                continue
+
+            output_file = (
+                output_path / f"{file_path.stem}{file_path.suffix}.md"
+            )
+            output_file.write_text(result.markdown, encoding="utf-8")
+            print(f"✓ Converted {file_path.name} → {output_file.name}")
+
+
+if __name__ == "__main__":
+    main("data", "output")

python-markitdown/convert_files.py

@@ -0,0 +1,5 @@
+from markitdown import MarkItDown
+
+md = MarkItDown()
+result = md.convert("./data/markdown_syntax.docx")
+print(result.markdown)

python-markitdown/data/employees.csv

@@ -0,0 +1,9 @@
+First Name,Last Name,Department,Position,Start Date
+Alice,Johnson,Marketing,Marketing Coordinator,1/15/2022
+Bob,Williams,Human Resources,HR Generalist,6/1/2021
+Carol,Davis,Engineering,Software Engineer,3/20/2023
+David,Brown,Sales,Sales Representative,9/10/2022
+Eve,Miller,Finance,Financial Analyst,11/5/2021
+Frank,Garcia,Customer Service,Customer Support Specialist,7/1/2023
+Grace,Rodriguez,Research & Development,Research Scientist,4/25/2022
+Henry,Martinez,Operations,Operations Manager,2/14/2021