Konvertera PowerPoint-presentationer till Markdown i C++
Introduktion
Aspose.Slides låter dig konvertera PowerPoint‑presentationer till Markdown, vilket kan vara användbart för dokumentationsarbetsflöden, statisk webbplatsgenerering, innehållsmigrering och versionskontrollerad textpublicering. API:et stöder direktexport från PPT‑ och PPTX‑presentationer till MD‑filer och erbjuder ytterligare alternativ för att styra hur bildinnehåll representeras i det resulterande Markdown‑dokumentet.
Du kan exportera presentationer som ren Markdown, välja mellan flera Markdown‑varianter såsom CommonMark och GitHub Flavored Markdown, samt konfigurera hur bilder hanteras under export. För presentationer som innehåller visuellt innehåll låter Aspose.Slides dig också spara bilder till en separat mapp och referera till dem från den genererade Markdown‑filen.
SaveOptions::MarkdownExportType::Visual) och också ange BasePath där bilderna som refereras i markdown‑dokumentet kommer att sparas.
Konvertera PowerPoint till Markdown
- Skapa en instans av klassen Presentation för att representera ett presentationsobjekt.
- Använd metoden Save för att spara objektet som en markdown‑fil.
Den här C++‑koden visar hur du konverterar PowerPoint till markdown:
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"pres.pptx");
pres->Save(u"pres.md", SaveFormat::Md);
Konvertera PowerPoint till Markdown‑variant
Aspose.Slides låter dig konvertera PowerPoint till markdown (med grundläggande syntax), CommonMark, GitHub flavored markdown, Trello, XWiki, GitLab och 17 andra markdown‑varianter.
Den här C++‑koden visar hur du konverterar PowerPoint till CommonMark:
auto pres = System::MakeObject<Presentation>(u"pres.pptx");
auto opt = System::MakeObject<MarkdownSaveOptions>();
opt->set_Flavor(Aspose::Slides::DOM::Export::Markdown::SaveOptions::Flavor::CommonMark);
pres->Save(u"pres.md", Aspose::Slides::Export::SaveFormat::Md, opt);
De 23 stödda markdown‑varianterna är listade under Flavor‑enumerationen från klassen MarkdownSaveOptions.
Konvertera en presentation som innehåller bilder till Markdown
Klassen MarkdownSaveOptions tillhandahåller egenskaper och enumerationer som låter dig använda vissa alternativ eller inställningar för den resulterande markdown‑filen. Enumerationen MarkdownExportType kan exempelvis sättas till värden som bestämmer hur bilder renderas eller hanteras: Sequential, TextOnly, Visual.
Konvertera bilder sekventiellt
Om du vill att bilderna ska visas en efter en i den resulterande markdown‑filen måste du välja det sekventiella alternativet. Den här C++‑koden visar hur du konverterar en presentation som innehåller bilder till markdown:
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"pres.pptx");
System::SharedPtr<MarkdownSaveOptions> markdownSaveOptions = System::MakeObject<MarkdownSaveOptions>();
markdownSaveOptions->set_ShowHiddenSlides(true);
markdownSaveOptions->set_ShowSlideNumber(true);
markdownSaveOptions->set_Flavor(Flavor::Github);
markdownSaveOptions->set_ExportType(MarkdownExportType::Sequential);
markdownSaveOptions->set_NewLineType(NewLineType::Windows);
pres->Save(u"doc.md", System::MakeArray<int32_t>({1, 2, 3, 4, 5, 6, 7, 8, 9}), SaveFormat::Md, markdownSaveOptions);
Konvertera bilder visuellt
Om du vill att bilderna ska visas tillsammans i den resulterande markdown‑filen måste du välja det visuella alternativet. I så fall sparas bilderna i programmets aktuella katalog (och en relativ sökväg byggs för dem i markdown‑dokumentet), eller så kan du ange en egen sökväg och mappnamn.
Den här C++‑koden demonstrerar operationen:
auto pres = System::MakeObject<Presentation>(u"pres.pptx");
const System::String outPath = u"x:\\documents";
auto opt = System::MakeObject<MarkdownSaveOptions>();
opt->set_ExportType(Aspose::Slides::DOM::Export::Markdown::SaveOptions::MarkdownExportType::Visual);
opt->set_ImagesSaveFolderName(u"md-images");
opt->set_BasePath(outPath);
pres->Save(System::IO::Path::Combine(outPath, u"pres.md"), Aspose::Slides::Export::SaveFormat::Md, opt);
Vanliga frågor
Fungerar hyperlänkar efter export till Markdown?
Ja. Text hyperlänkar bevaras som standard‑Markdown‑länkar. Bild övergångar och animationer konverteras inte.
Kan jag påskynda konverteringen genom att köra den i flera trådar?
Du kan parallellisera över filer, men dela inte samma [Presentation]‑instans över trådar. Använd separata instanser/processer per fil för att undvika konkurrens.
Vad händer med bilder—var sparas de och är sökvägarna relativa?
Bilder exporteras till en dedikerad mapp, och Markdown‑filen refererar till dem med relativa sökvägar som standard. Du kan konfigurera den grundläggande utmatningssökvägen och asset‑mappnamnet för att behålla en förutsägbar arkivstruktur.