Traduzir Markdown para Document Object Model (DOM)

Para ler, manipular e modificar programaticamente o conteúdo e a formatação de um documento, é necessário traduzi-lo para o modelo de objeto de documento Aspose.Words (DOM).

Em contraste com os documentos do Word, Markdown não está em conformidade com o DOM descrito no Aspose.Words Modelo De Objecto Do Documento (DOM) artigo. No entanto, Aspose.Words fornece seu próprio mecanismo para traduzir Markdown documentos para DOM e vice-versa, para que possamos trabalhar com sucesso com seus elementos, como formatação de texto, tabelas, cabeçalhos e outros.

Este artigo explica como as várias características markdown podem ser traduzidas para o formato Aspose.Words DOM e de volta para o formato Markdown.

Complexidade da tradução Markdown – DOM – Markdown

A principal dificuldade deste mecanismo não é apenas traduzir Markdown para DOM, mas também fazer a transformação inversa – salvar o documento de volta ao formato Markdown com perda mínima. Existem elementos, como aspas multiníveis, para os quais a transformação inversa não é trivial.

Nosso mecanismo de Tradução permite que os usuários não apenas trabalhem com elementos complexos em um documento Markdown existente, mas também criem seu próprio documento no formato Markdown com a estrutura original do zero. Para criar vários elementos, você precisa usar estilos com nomes específicos de acordo com certas regras descritas posteriormente neste artigo. Esses estilos podem ser criados programaticamente.

Princípios Comuns De Tradução

Usamos formatação Font para blocos embutidos. Quando não há correspondência direta para um recurso Markdown em Aspose.Words DOM, usamos um estilo de caractere com um nome que começa com algumas palavras especiais.

Para blocos de contêiner, usamos herança de estilo para denotar recursos Markdown aninhados. Nesse caso, mesmo quando não há recursos aninhados, também usamos estilos de parágrafo com um nome que começa com algumas palavras especiais.

As listas com marcadores e ordenadas também são blocos de contentores em Markdown. Seu aninhamento é representado em DOM da mesma forma que para todos os outros blocos de contêiner usando herança de estilo. No entanto, além disso, as listas em DOM têm formatação numérica correspondente no estilo de lista ou formatação de parágrafo.

Blocos Inline

Usamos a formatação Font ao traduzir os recursos Bold, Italic ou Strikethrough inline markdown.

Markdown recurso	Aspose.Words
Bold **bold text**	get_Font()->set_Bold(true)
Italic *italic text*	get_Font()->set_Italic(true)
Strikethrough ~Strikethrough text~	get_Font()->set_StrikeThrough(true)

Usamos um estilo de caractere com um nome que começa a partir da palavra InlineCode, seguido por um ponto opcional (.) e um número de crases (`) para o recurso InlineCode. Se um número de crases for perdido, um crase será usado por padrão.

Markdown recurso	Aspose.Words
InlineCode **inline code**	get_Font()->set_StyleName(u"InlineCode[.][N]")
Autolink <scheme://domain.com> <[e-mail]>	A classe FieldHyperlink.
Link [link text](url) [link text](<url>"title") [link text](url 'title') [link text](url (title))	A classe FieldHyperlink.
Image  ![alt text](<url>"title")  )	A classe Shape.

Blocos De Contentores

Um documento é uma sequência de blocos de contentores, tais como títulos, parágrafos, listas, citações e outros. Os blocos de contentores podem ser divididos em 2 classes: Blocos de folhas e contentores complexos. Os blocos folha só podem conter conteúdo embutido. Os contentores complexos, por sua vez, podem conter outros blocos de contentores, incluindo blocos de folhas.

Blocos De Folhas

A tabela abaixo mostra exemplos de utilização de Markdown Blocos de folhas em Aspose.Words:

Markdown recurso	Aspose.Words
HorizontalRule -----	Este é um parágrafo simples com uma forma HorizontalRule correspondente: DocumentBuilder::InsertHorizontalRule()
ATX Heading # H1, ## H2, ### H3…	get_ParagraphFormat()->set_StyleName(u"Heading N"), onde (1<= N <= 9). Isso é traduzido em um estilo embutido e deve ser exatamente do padrão especificado (não são permitidos sufixos ou prefixos). Caso contrário, será apenas um parágrafo regular com um estilo correspondente.
Setext Heading === (if Heading level 1), --- (if Heading level 2)	get_ParagraphFormat->set_StyleName(u"SetextHeading[some suffix]"), com base no estilo "Heading N". Se (N > = 2), então "Heading 2" será usado, caso contrário "Heading 1". Qualquer sufixo é permitido, mas o importador Aspose.Words utiliza os números “1” e “2”, respectivamente.
Indented Code	get_ParagraphFormat->set_StyleName(u"IndentedCode[some suffix]")
Fenced Code ``` c# if () then else ```	get_ParagraphFormat()->set_StyleName(u"FencedCode[.][info string]") Os [.] e [info string] são opcionais.

Contentores Complexos

A tabela abaixo mostra exemplos de utilização de Markdown contentores complexos em Aspose.Words:

Markdown recurso	Aspose.Words
Quote > quote, >> nested quote	get_ParagraphFormat()->set_StyleName(u"Quote[some suffix]") O sufixo no nome do estilo é opcional, mas Aspose.Words importador usa os números ordenados1, 2, 3, …. no caso de citações aninhadas. O aninhamento é definido através dos estilos herdados.
BulletedList - Item 1 - Item 2 - Item 2a - Item 2b	As listas com marcadores são representadas através da numeração de parágrafos: get_ListFormat()->ApplyBulletDefault() Pode haver 3 tipos de listas com marcadores. Eles são apenas diff em um formato de numeração do primeiro nível. Estes são: ‘-’, ‘+’ ou ‘*’ respectivamente.
OrderedList 1. Item 1 2. Item 2 1) Item 2a 2) Item 2b	As listas ordenadas são representadas através da numeração de parágrafos: get_ListFormat()->ApplyNumberDefault() Pode haver marcadores de formato numérico 2: ‘.’ e ‘)’. O marcador predefinido é ‘.’.

Quadros

Aspose.Words também permite traduzir tabelas em DOM, Como mostrado abaixo:

Markdown recurso	Aspose.Words
Table a|b -|- c|d	Table, Row e Cell classes.

Ver Também

• Trabalhando com Markdown Recursos