Konversi Presentasi PowerPoint ke Markdown dalam JavaScript

Pendahuluan

Aspose.Slides memungkinkan Anda mengonversi presentasi PowerPoint ke Markdown, yang dapat berguna untuk alur kerja dokumentasi, pembuatan situs statis, migrasi konten, dan penerbitan teks yang dikontrol versi. API mendukung ekspor langsung dari presentasi PPT dan PPTX ke file MD dan menyediakan opsi tambahan untuk mengontrol bagaimana konten slide direpresentasikan dalam dokumen Markdown yang dihasilkan.

Anda dapat mengekspor presentasi sebagai Markdown biasa, memilih dari berbagai varian Markdown seperti CommonMark dan GitHub Flavored Markdown, serta mengonfigurasi cara gambar ditangani selama ekspor. Untuk presentasi yang berisi konten visual, Aspose.Slides juga memungkinkan Anda menyimpan gambar ke folder terpisah dan merujuknya dari file Markdown yang dihasilkan.

Ekspor PowerPoint ke markdown tanpa gambar secara default. Jika Anda ingin mengekspor dokumen PowerPoint yang berisi gambar, Anda perlu memanggil markdownSaveOptions.setExportType(MarkdownExportType.Visual) dan juga mengatur BasePath tempat gambar yang dirujuk dalam dokumen markdown akan disimpan.

Konversi PowerPoint ke Markdown

1. Buat instance dari kelas Presentation untuk mewakili objek presentasi.
2. Gunakan metode save untuk menyimpan objek sebagai file markdown.

Kode JavaScript ini menunjukkan cara mengonversi PowerPoint ke markdown:

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

Konversi PowerPoint ke Varian Markdown

Aspose.Slides memungkinkan Anda mengonversi PowerPoint ke markdown (yang berisi sintaks dasar), CommonMark, GitHub flavored markdown, Trello, XWiki, GitLab, dan 17 varian markdown lainnya.

Kode JavaScript ini menunjukkan cara mengonversi PowerPoint ke 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();
    }
}

23 varian markdown yang didukung didaftar di bawah enumeration Flavor dari kelas MarkdownSaveOptions.

Konversi Presentasi yang Mengandung Gambar ke Markdown

Kelas MarkdownSaveOptions menyediakan properti dan enumerasi yang memungkinkan Anda menggunakan opsi atau pengaturan tertentu untuk file markdown yang dihasilkan. Enum MarkdownExportType, misalnya, dapat diatur ke nilai yang menentukan bagaimana gambar dirender atau ditangani: Sequential, TextOnly, Visual.

Konversi Gambar Secara Berurutan

Jika Anda ingin gambar muncul secara individual satu demi satu dalam markdown yang dihasilkan, Anda harus memilih opsi sequential. Kode JavaScript ini menunjukkan cara mengonversi presentasi yang berisi gambar ke 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();
    }
}

Konversi Gambar Secara Visual

Jika Anda ingin gambar muncul bersama dalam markdown yang dihasilkan, Anda harus memilih opsi visual. Dalam hal ini, gambar akan disimpan ke direktori saat ini dari aplikasi (dan jalur relatif akan dibuat untuknya dalam dokumen markdown), atau Anda dapat menentukan jalur dan nama folder yang Anda inginkan.

Kode JavaScript ini mendemonstrasikan operasinya:

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();
    }
}

FAQ

Do hyperlinks survive the export to Markdown?

Ya. Teks hyperlinks dipertahankan sebagai tautan Markdown standar. Slide transitions dan animations tidak dikonversi.

Can I speed up conversion by running it in multiple threads?

Anda dapat memparalelkan antar file, tetapi don’t share instance Presentation yang sama di antara utas. Gunakan instance/proses terpisah per file untuk menghindari kontensi.

What happens to images—where are they saved, and are the paths relative?

Images diekspor ke folder khusus, dan file Markdown merujuknya dengan jalur relatif secara default. Anda dapat mengonfigurasi jalur output dasar dan nama folder aset untuk menjaga struktur repositori yang dapat diprediksi.