Converter Apresentações PowerPoint para Markdown em C++
Introdução
Aspose.Slides permite converter apresentações PowerPoint para Markdown, o que pode ser útil em fluxos de documentação, geração de sites estáticos, migração de conteúdo e publicação de texto versionado. A API oferece exportação direta de apresentações PPT e PPTX para arquivos MD e fornece opções adicionais para controlar como o conteúdo dos slides é representado no documento Markdown resultante.
Você pode exportar apresentações como Markdown puro, escolher entre vários sabores de Markdown, como CommonMark e GitHub Flavored Markdown, e configurar como as imagens são tratadas durante a exportação. Para apresentações que contêm conteúdo visual, o Aspose.Slides também permite salvar as imagens em uma pasta separada e referenciá‑las a partir do arquivo Markdown gerado.
SaveOptions::MarkdownExportType::Visual) e também definir o BasePath onde as imagens referenciadas no documento markdown serão salvas.
Converter PowerPoint para Markdown
- Crie uma instância da classe Presentation para representar um objeto de apresentação.
- Use o método Save para salvar o objeto como um arquivo markdown.
Este código C++ mostra como converter PowerPoint para markdown:
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"pres.pptx");
pres->Save(u"pres.md", SaveFormat::Md);
Converter PowerPoint para um Sabor de Markdown
Aspose.Slides permite converter PowerPoint para markdown (contendo sintaxe básica), CommonMark, GitHub flavored markdown, Trello, XWiki, GitLab e 17 outros sabores de markdown.
Este código C++ mostra como converter PowerPoint para 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);
Os 23 sabores de markdown suportados estão listados na enumeração Flavor da classe MarkdownSaveOptions.
Converter uma Apresentação contendo Imagens para Markdown
A classe MarkdownSaveOptions fornece propriedades e enumerações que permitem usar determinadas opções ou configurações para o arquivo markdown resultante. O enum MarkdownExportType, por exemplo, pode ser definido com valores que determinam como as imagens são renderizadas ou tratadas: Sequential, TextOnly, Visual.
Converter Imagens Sequencialmente
Se você desejar que as imagens apareçam individualmente, uma após a outra, no markdown resultante, deve escolher a opção sequencial. Este código C++ mostra como converter uma apresentação contendo imagens para 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);
Converter Imagens Visualmente
Se você quiser que as imagens apareçam juntas no markdown resultante, deve escolher a opção visual. Nesse caso, as imagens serão salvas no diretório atual da aplicação (e um caminho relativo será criado para elas no documento markdown), ou você pode especificar o caminho e o nome da pasta de sua preferência.
Este código C++ demonstra a operação:
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);
FAQ
Os hyperlinks permanecem após a exportação para Markdown?
Sim. Os hyperlinks de texto são preservados como links Markdown padrão. As transições e animações dos slides não são convertidas.
Posso acelerar a conversão executando‑a em múltiplas threads?
É possível paralelizar por arquivos, mas não compartilhe a mesma instância de Presentation entre threads. Use instâncias/processos separados por arquivo para evitar contenção.
O que acontece com as imagens — onde são salvas e os caminhos são relativos?
As imagens são exportadas para uma pasta dedicada, e o arquivo Markdown as referencia com caminhos relativos por padrão. Você pode configurar o caminho de saída base e o nome da pasta de ativos para manter uma estrutura de repositório previsível.