Konvertera PowerPoint-presentationer till Markdown i JavaScript

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 direkt export 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, och konfigurera hur bilder hanteras under export. För presentationer som innehåller visuellt innehåll låter Aspose.Slides dig även spara bilder i en separat mapp och referera till dem från den genererade Markdown-filen.

PowerPoint‑till‑Markdown‑export är utan bilder som standard. Om du vill exportera ett PowerPoint‑dokument som innehåller bilder måste du anropa markdownSaveOptions.setExportType(MarkdownExportType.Visual) och även ange BasePath där bilderna som refereras i Markdown‑dokumentet kommer att sparas.

Konvertera PowerPoint till Markdown

1. Skapa en instans av klassen Presentation för att representera ett presentationsobjekt.
2. Använd metoden save för att spara objektet som en markdown‑fil.

JavaScript‑koden visar hur du konverterar PowerPoint till markdown:

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    pres.save("pres.md", aspose.slides.SaveFormat.Md);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

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.

JavaScript‑koden visar hur du konverterar PowerPoint till CommonMark:

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var markdownSaveOptions = new aspose.slides.MarkdownSaveOptions();
    markdownSaveOptions.setFlavor(aspose.slides.Flavor.CommonMark);
    pres.save("pres.md", aspose.slides.SaveFormat.Md, markdownSaveOptions);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

De 23 stödda markdown‑varianterna är listade under Flavor‑enumerationen från klassen MarkdownSaveOptions.

Konvertera presentation med 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 t.ex. 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 individuellt, en efter en, i den resulterande markdown‑filen måste du välja det sekventiella alternativet. Denna JavaScript‑kod visar hur du konverterar en presentation med bilder till markdown:

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var markdownSaveOptions = new aspose.slides.MarkdownSaveOptions();
    markdownSaveOptions.setShowHiddenSlides(true);
    markdownSaveOptions.setShowSlideNumber(true);
    markdownSaveOptions.setFlavor(aspose.slides.Flavor.Github);
    markdownSaveOptions.setExportType(aspose.slides.MarkdownExportType.Sequential);
    markdownSaveOptions.setNewLineType(aspose.slides.NewLineType.Windows);
    pres.save("doc.md", java.newArray("int", [1, 2, 3, 4, 5, 6, 7, 8, 9]), aspose.slides.SaveFormat.Md, markdownSaveOptions);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

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 applikationens 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.

Denna JavaScript‑kod demonstrerar operationen:

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    final var outPath = "c:/documents";
    var markdownSaveOptions = new aspose.slides.MarkdownSaveOptions();
    markdownSaveOptions.setExportType(aspose.slides.MarkdownExportType.Visual);
    markdownSaveOptions.setImagesSaveFolderName("md-images");
    markdownSaveOptions.setBasePath(outPath);
    pres.save("pres.md", aspose.slides.SaveFormat.Md, markdownSaveOptions);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Vanliga frågor

Behåller hyperlänkar exporten till Markdown?

Ja. Text-hyperlänkar bevaras som vanliga 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 bas‑utdata‑sökväg och tillgångsmappens namn för att behålla en förutsägbar lagringsstruktur.