Konwertowanie prezentacji PowerPoint do Markdown w Pythonie
Wprowadzenie
Aspose.Slides umożliwia konwertowanie prezentacji PowerPoint do formatu Markdown, co może być przydatne w procesach dokumentacji, generowaniu statycznych witryn, migracji treści oraz publikacji tekstów kontrolowanych wersjami. API obsługuje bezpośredni eksport prezentacji PPT i PPTX do plików MD i zapewnia dodatkowe opcje kontrolujące sposób reprezentacji zawartości slajdów w wygenerowanym dokumencie Markdown.
Możesz eksportować prezentacje jako czysty Markdown, wybierać spośród wielu odmian Markdown, takich jak CommonMark i GitHub Flavored Markdown, oraz konfigurować sposób obsługi obrazów podczas eksportu. Dla prezentacji zawierających treść wizualną Aspose.Slides umożliwia także zapisywanie obrazów w oddzielnym folderze i odwoływanie się do nich z wygenerowanego pliku Markdown.
export_type = MarkdownExportType.VISUAL i określić base_path, gdzie zostaną zapisane obrazy odwoływane w dokumencie Markdown.
Konwertowanie prezentacji do Markdown
Poniższy przykład pokazuje najprostszy sposób konwersji prezentacji PowerPoint do Markdown przy użyciu Aspose.Slides dla Pythona via .NET z ustawieniami domyślnymi.
- Utwórz instancję Presentation, aby załadować prezentację.
- Wywołaj
save, aby wyeksportować ją jako plik Markdown.
Użyj poniższego fragmentu kodu Python, aby wykonać konwersję:
import aspose.slides as slides
with slides.Presentation("presentation.pptx") as presentation:
presentation.save("presentation.md", slides.export.SaveFormat.MD)
Konwertowanie prezentacji do odmiany Markdown
Aspose.Slides umożliwia konwertowanie prezentacji do formatów Markdown, w tym podstawowego Markdown, CommonMark, GitHub-flavored Markdown, Trello, XWiki, GitLab oraz 17 innych odmian Markdown.
Poniższy przykład w Pythonie pokazuje, jak przekonwertować prezentację PowerPoint do CommonMark:
import aspose.slides as slides
save_options = slides.export.MarkdownSaveOptions()
save_options.flavor = slides.export.Flavor.COMMON_MARK
with slides.Presentation("presentation.pptx") as presentation:
presentation.save("presentation.md", slides.export.SaveFormat.MD, save_options)
23 obsługiwane odmiany Markdown są wymienione w wyliczeniu Flavor klasy MarkdownSaveOptions.
Konwertowanie prezentacji zawierających obrazy do Markdown
Klasa MarkdownSaveOptions udostępnia właściwości i wyliczenia, które pozwalają skonfigurować wynikowy plik Markdown. Na przykład wyliczenie MarkdownExportType steruje sposobem obsługi obrazów: SEQUENTIAL, TEXT_ONLY lub VISUAL.
Konwertowanie obrazów sekwencyjnie
Jeśli chcesz, aby obrazy pojawiały się kolejno — jeden po drugim — w wygenerowanym Markdownzie, wybierz opcję SEQUENTIAL. Poniższy przykład w Pythonie pokazuje, jak przekonwertować prezentację z obrazami do Markdown.
import aspose.slides as slides
save_options = slides.export.MarkdownSaveOptions()
save_options.show_hidden_slides = True
save_options.show_slide_number = True
save_options.flavor = slides.export.Flavor.GITHUB
save_options.export_type = slides.export.MarkdownExportType.SEQUENTIAL
save_options.new_line_type = slides.export.NewLineType.WINDOWS
slide_indices = [1, 3, 5]
with slides.Presentation("presentation.pptx") as presentation:
presentation.save("presentation.md", slide_indices, slides.export.SaveFormat.MD, save_options)
Konwertowanie obrazów wizualnie
Jeśli chcesz, aby obrazy pojawiły się razem w wynikowym Markdownzie, wybierz opcję VISUAL. W tym trybie obrazy są zapisywane do bieżącego katalogu aplikacji (a dokument Markdown używa ścieżek względnych) lub możesz określić własną ścieżkę wyjściową oraz nazwę folderu.
Poniższy przykład w Pythonie demonstruje tę operację:
import os
import aspose.slides as slides
save_options = slides.export.MarkdownSaveOptions()
save_options.export_type = slides.export.MarkdownExportType.VISUAL
save_options.images_save_folder_name = "md-images"
save_options.base_path = "c:\\documents"
with slides.Presentation("presentation.pptx") as presentation:
file_path = os.path.join(save_options.base_path, "presentation.md")
presentation.save(file_path, slides.export.SaveFormat.MD, save_options)
FAQ
Czy hiperłącza przetrwają eksport do Markdown?
Tak. Tekstowe hiperlinki są zachowane jako standardowe linki Markdown. Przejścia slajdów i animacje nie są konwertowane.
Czy mogę przyspieszyć konwersję uruchamiając ją w wielu wątkach?
Możesz równolegle przetwarzać pliki, ale nie udostępniaj tej samej instancji Presentation między wątkami. Używaj oddzielnych instancji/procesów dla każdego pliku, aby uniknąć konfliktów.
Co się dzieje z obrazami — gdzie są zapisywane i czy ścieżki są względne?
Obrazy są eksportowane do dedykowanego folderu, a plik Markdown odwołuje się do nich domyślnie za pomocą ścieżek względnych. Możesz skonfigurować podstawową ścieżkę wyjściową oraz nazwę folderu zasobów, aby utrzymać przewidywalną strukturę repozytorium.