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(tools): support markdown companion assets import

hugohe3a64f749e8fc4
diff --git a/tools/pdf_to_md.py b/tools/pdf_to_md.py
index 01bc99bc..e5b2f671 100644
--- a/tools/pdf_to_md.py
+++ b/tools/pdf_to_md.py
@@ -368,9 +368,10 @@ def extract_pdf_to_markdown(pdf_path: str, output_path: str = None) -> str:
markdown_content = f"# {title}\n\n"
img_dir = None
- rel_img_dir = "images"
+ rel_img_dir = None
if output_path:
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)
diff --git a/tools/project_manager.py b/tools/project_manager.py
index c9f6a782..aed99aaf 100644
--- a/tools/project_manager.py
+++ b/tools/project_manager.py
@@ -173,6 +173,20 @@ class ProjectManager:
shutil.copy2(source, destination)
return destination
+ def _copy_or_move_tree(self, source: Path, destination: Path, move: bool) -> Path:
+ try:
+ if source.resolve() == destination.resolve():
+ return destination
+ except FileNotFoundError:
+ pass
+
+ destination = self._ensure_unique_path(destination)
+ if move:
+ shutil.move(str(source), str(destination))
+ else:
+ shutil.copytree(source, destination)
+ return destination
+
def _run_tool(self, args: List[str]) -> None:
try:
result = subprocess.run(
@@ -232,6 +246,61 @@ class ProjectManager:
target.write_text(content, encoding="utf-8")
return target
+ def _companion_asset_dir(self, source_path: Path) -> Optional[Path]:
+ candidate = source_path.with_name(f"{source_path.stem}_files")
+ if candidate.exists() and candidate.is_dir():
+ return candidate
+ return None
+
+ def _rewrite_markdown_asset_refs(
+ self,
+ markdown_path: Path,
+ original_asset_dirname: str,
+ imported_asset_dirname: str,
+ ) -> None:
+ if original_asset_dirname == imported_asset_dirname:
+ return
+
+ content = markdown_path.read_text(encoding="utf-8", errors="replace")
+ updated = content.replace(f"{original_asset_dirname}/", f"{imported_asset_dirname}/")
+ if updated != content:
+ markdown_path.write_text(updated, encoding="utf-8")
+
+ def _import_markdown_with_assets(
+ self,
+ source_path: Path,
+ sources_dir: Path,
+ move: bool,
+ ) -> Tuple[Path, Optional[Path], Optional[str]]:
+ archived_markdown = self._copy_or_move_file(
+ source_path,
+ sources_dir / source_path.name,
+ move=move,
+ )
+
+ asset_dir = self._companion_asset_dir(source_path)
+ if asset_dir is None:
+ return archived_markdown, None, None
+
+ imported_asset_dir = self._copy_or_move_tree(
+ asset_dir,
+ sources_dir / f"{archived_markdown.stem}_files",
+ move=move,
+ )
+ self._rewrite_markdown_asset_refs(
+ archived_markdown,
+ original_asset_dirname=asset_dir.name,
+ imported_asset_dirname=imported_asset_dir.name,
+ )
+
+ note = None
+ if archived_markdown.stem != source_path.stem:
+ note = (
+ f"{source_path}: renamed imported markdown to {archived_markdown.name} "
+ f"and rewrote asset references to {imported_asset_dir.name}/"
+ )
+ return archived_markdown, imported_asset_dir, note
+
def import_sources(
self,
project_path: str,
@@ -248,6 +317,7 @@ class ProjectManager:
summary: Dict[str, List[str]] = {
"archived": [],
"markdown": [],
+ "assets": [],
"notes": [],
"skipped": [],
}
@@ -285,6 +355,22 @@ class ProjectManager:
continue
effective_move = move or is_within_path(source_path, REPO_ROOT)
+ suffix = source_path.suffix.lower()
+
+ if suffix in {".md", ".markdown"}:
+ archived_markdown, asset_dir, note = self._import_markdown_with_assets(
+ source_path,
+ sources_dir,
+ move=effective_move,
+ )
+ summary["archived"].append(str(archived_markdown))
+ summary["markdown"].append(str(archived_markdown))
+ if asset_dir is not None:
+ summary["assets"].append(str(asset_dir))
+ if note:
+ summary["notes"].append(note)
+ continue
+
archived_path = self._copy_or_move_file(
source_path,
sources_dir / source_path.name,
@@ -292,7 +378,6 @@ class ProjectManager:
)
summary["archived"].append(str(archived_path))
- suffix = source_path.suffix.lower()
if suffix in PDF_SUFFIXES:
canonical_markdown_path = sources_dir / f"{archived_path.stem}.md"
if archived_path.stem in explicit_markdown_stems:
@@ -315,8 +400,6 @@ class ProjectManager:
elif suffix == ".txt":
markdown_path = self._normalize_text_source(archived_path, sources_dir)
summary["markdown"].append(str(markdown_path))
- elif suffix in {".md", ".markdown"}:
- summary["markdown"].append(str(archived_path))
else:
summary["notes"].append(f"{item}: archived only, no automatic conversion")
@@ -426,6 +509,10 @@ def main() -> None:
print("\nNormalized markdown:")
for item in summary["markdown"]:
print(f" - {item}")
+ if summary["assets"]:
+ print("\nImported asset directories:")
+ for item in summary["assets"]:
+ print(f" - {item}")
if summary["notes"]:
print("\nNotes:")
for item in summary["notes"]: