Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

feat(pdf_to_md): add --images mode flag with all/filtered/none options

hugohe3c6bcf4cd1aa5
diff --git a/skills/ppt-master/scripts/docs/conversion.md b/skills/ppt-master/scripts/docs/conversion.md
index efe03cce..5be9b524 100644
--- a/skills/ppt-master/scripts/docs/conversion.md
+++ b/skills/ppt-master/scripts/docs/conversion.md
@@ -13,6 +13,11 @@ python3 scripts/source_to_md/pdf_to_md.py book.pdf
python3 scripts/source_to_md/pdf_to_md.py book.pdf -o output.md
python3 scripts/source_to_md/pdf_to_md.py ./pdfs
python3 scripts/source_to_md/pdf_to_md.py ./pdfs -o ./markdown
+
+# Image extraction control (default: filtered)
+python3 scripts/source_to_md/pdf_to_md.py book.pdf --images filtered # size/quality filters applied
+python3 scripts/source_to_md/pdf_to_md.py book.pdf --images all # extract all images, no filtering
+python3 scripts/source_to_md/pdf_to_md.py book.pdf --images none # skip all images (text only)
```
Use cases:
diff --git a/skills/ppt-master/scripts/source_to_md/pdf_to_md.py b/skills/ppt-master/scripts/source_to_md/pdf_to_md.py
index 551c3077..096d1fdc 100644
--- a/skills/ppt-master/scripts/source_to_md/pdf_to_md.py
+++ b/skills/ppt-master/scripts/source_to_md/pdf_to_md.py
@@ -455,9 +455,16 @@ def should_merge_lines(current: dict, next_line: dict) -> bool:
return True
-def extract_pdf_to_markdown(pdf_path: str, output_path: str = None) -> str:
- """
- Extract text, images, and tables from a PDF and convert to Markdown.
+def extract_pdf_to_markdown(pdf_path: str, output_path: str = None, images: str = "filtered") -> str:
+ """Extract text, images, and tables from a PDF and convert to Markdown.
+
+ Args:
+ pdf_path: Path to the PDF file.
+ output_path: Optional output path for the Markdown file.
+ images: Image extraction mode.
+ "filtered" = apply size/quality filters (default),
+ "all" = extract all images without filtering,
+ "none" = skip all images.
"""
try:
doc = fitz.open(pdf_path)
@@ -465,6 +472,11 @@ def extract_pdf_to_markdown(pdf_path: str, output_path: str = None) -> str:
print(f"[ERROR] Failed to open PDF file: {e}")
return ""
+ if len(doc) >= 200:
+ print(f"[HINT] {len(doc)} pages — for very large PDFs, consider splitting "
+ f"the source by chapter beforehand (e.g. with pdftk / qpdf / PyPDF2) "
+ f"and converting each part individually.")
+
filename = Path(pdf_path).stem
title = re.sub(r'^\d+-', '', filename).strip()
@@ -489,8 +501,6 @@ def extract_pdf_to_markdown(pdf_path: str, output_path: str = None) -> str:
output_path = Path(output_path)
rel_img_dir = f"{output_path.stem}_files"
img_dir = output_path.parent / rel_img_dir
- if not img_dir.exists():
- img_dir.mkdir(parents=True, exist_ok=True)
img_count = 0
@@ -605,7 +615,9 @@ def extract_pdf_to_markdown(pdf_path: str, output_path: str = None) -> str:
})
elif block["type"] == 1:
- if should_keep_image(block, page.rect, seen_image_hashes):
+ if images == "none":
+ pass
+ elif images == "all" or should_keep_image(block, page.rect, seen_image_hashes):
page_elements.append({
"y0": block["bbox"][1],
"type": 1,
@@ -714,6 +726,7 @@ def extract_pdf_to_markdown(pdf_path: str, output_path: str = None) -> str:
image_path = img_dir / image_name
try:
+ img_dir.mkdir(parents=True, exist_ok=True)
with open(image_path, "wb") as f:
f.write(image_data)
@@ -744,12 +757,13 @@ def extract_pdf_to_markdown(pdf_path: str, output_path: str = None) -> str:
return markdown_content
-def process_directory(input_dir: str, output_dir: str | None = None) -> None:
+def process_directory(input_dir: str, output_dir: str | None = None, images: str = "filtered") -> None:
"""Convert all PDFs in a directory to Markdown.
Args:
input_dir: Directory containing PDF files.
output_dir: Optional output directory for Markdown files.
+ images: Image extraction mode passed through to each file conversion.
"""
input_path = Path(input_dir)
@@ -765,7 +779,7 @@ def process_directory(input_dir: str, output_dir: str | None = None) -> None:
for pdf_file in pdf_files:
output_file = output_path / (pdf_file.stem + '.md')
print(f"Processing: {pdf_file.name}")
- extract_pdf_to_markdown(str(pdf_file), str(output_file))
+ extract_pdf_to_markdown(str(pdf_file), str(output_file), images=images)
def main() -> int:
@@ -792,6 +806,12 @@ Structure detection features:
parser.add_argument('input', help='PDF file or directory containing PDFs')
parser.add_argument('-o', '--output', help='Output file or directory')
+ parser.add_argument(
+ '--images',
+ choices=['all', 'filtered', 'none'],
+ default='filtered',
+ help='Image extraction mode: filtered=apply size/quality filters (default), all=no filtering, none=skip images',
+ )
args = parser.parse_args()
@@ -799,9 +819,9 @@ Structure detection features:
if input_path.is_file():
output = args.output or str(input_path.with_suffix('.md'))
- extract_pdf_to_markdown(str(input_path), output)
+ extract_pdf_to_markdown(str(input_path), output, images=args.images)
elif input_path.is_dir():
- process_directory(str(input_path), args.output)
+ process_directory(str(input_path), args.output, images=args.images)
else:
print(f"Error: File or directory not found: {args.input}")
return 1