Converter um documento em Markdown

Markdown é um formato popular usado para marcar texto e está ainda convertendo para HTML, PDF, DOCX, ou outros formatos. Muitos desenvolvedores escolhem esse formato para escrever documentação, preparar artigos para publicação em blogs, descrever projetos e assim por diante.

Markdown é tão popular porque é fácil trabalhar com este formato, assim como pode ser simplesmente convertido para outros formatos. Por esta razão, Aspose.Words fornece a capacidade de converter um documento em qualquer formato de carga suportado para Markdown e vice – versa - Aspose.Words também suporta o mais popular salvar formatos.

Agora, a funcionalidade para trabalhar com o formato Markdown está sendo ativamente desenvolvida para fornecer mais oportunidades de trabalho conveniente e confortável com documentos.

Converter um documento em Markdown

Para converter um documento em Markdown, basta carregar um documento em qualquer formato suportado ou criar um novo programaticamente. Em seguida, você precisa salvar o documento no formato Markdown.

O exemplo de código a seguir mostra como converter DOCX em Markdown:

Especifique as opções de salvamento ao converter para Markdown

Aspose.Words fornece a capacidade de usar a classe MarkdownSaveOptions para trabalhar com opções avançadas ao salvar um documento no formato Markdown. Além de outras propriedades herdadas ou de sobrecarga, também foram adicionadas várias propriedades específicas para o formato Markdown. Por exemplo, a propriedade TableContentAlignment para controlar o alinhamento do conteúdo em tabelas ou ImageSavingCallback e ImagesFolder para controlar como as imagens são salvas ao converter um documento para o formato Markdown.

Recursos Markdown Suportados

Aspose.Words atualmente suporta os seguintes recursos Markdown, que seguem principalmente a especificação CommonMark no Aspose.Words API e são representados como estilos apropriados ou formatação direta:

• Os títulos são parágrafos com estilos Heading 1 - Heading 6
• Blockquotes são parágrafos com “aspas” no nome do estilo
• IndentedCode são parágrafos com “IndentedCode " no nome do estilo
• FencedCode são parágrafos com “FencedCode " no nome do estilo
• InlineCode são executadas com “InlineCode " no nome do estilo Font
• Regras horizontais são parágrafos com a forma HorizontalRule
• Ênfase ousada
• Ênfase em itálico
• StrikeThrough formatação
• As listas são parágrafos numerados ou com marcadores
• As tabelas são representadas com a classe Table
• Os Links são representados como a classe FieldHyperlink

O exemplo a seguir mostra como criar um documento com alguns estilos e salvá-lo em Markdown:

O resultado deste exemplo de código é mostrado abaixo.

Dicas Úteis

Existem várias nuances e casos interessantes, tendo aprendido que você pode trabalhar com Markdown arquivos de forma mais flexível e conveniente. Por exemplo, existe a capacidade de usar:

• SetextHeading que permite criar títulos de várias linhas em Markdown, enquanto os títulos regulares em Markdown só podem ser de uma única linha. SetextHeading baseia-se num estilo “título N” e o seu nível só pode ser 1 ou 2. Se N na " posição N “for maior ou igual a 2, então o SetextHeading correspondente é baseado em” Heading 2”, caso contrário, em"Heading 1”.
• Marcadores diferentes para o primeiro nível de listas com marcadores ("-”, “+” ou “*”, o marcador predefinido é “-”.) e diferentes tipos de numeração para listas ordenadas ("." ou “)”, o marcador predefinido é “.").