Traducir Markdown a modelo de objetos de documento (DOM)

Para leer, manipular y modificar mediante programación el contenido y el formato de un documento, debe traducirlo al modelo de objetos de documento (DOM) Aspose.Words.

A diferencia de los documentos de Word, Markdown no se ajusta al DOM descrito en el artículo Modelo de objetos de documento Aspose.Words (DOM). Sin embargo, Aspose.Words proporciona su propio mecanismo para traducir documentos Markdown a DOM y viceversa, de modo que podamos trabajar exitosamente con sus elementos como formato de texto, tablas, encabezados y otros.

Este artículo explica cómo las diversas funciones markdown se pueden traducir a Aspose.Words DOM y volver al formato Markdown.

Complejidad de la traducción Markdown – DOM – Markdown

La principal dificultad de este mecanismo no es sólo traducir Markdown a DOM, sino también realizar la transformación inversa: guardar el documento nuevamente en formato Markdown con una pérdida mínima. Hay elementos, como las comillas multinivel, para los que la transformación inversa no es trivial.

Nuestro motor de traducción permite a los usuarios no sólo trabajar con elementos complejos en un documento Markdown existente, sino también crear su propio documento en formato Markdown con la estructura original desde cero. Para crear varios elementos, debe utilizar estilos con nombres específicos de acuerdo con ciertas reglas que se describen más adelante en este artículo. Estos estilos se pueden crear mediante programación.

Principios comunes de traducción

Usamos formato Font para bloques en línea. Cuando no existe una correspondencia directa para una característica Markdown en Aspose.Words DOM, utilizamos un estilo de carácter con un nombre que comienza con algunas palabras especiales.

Para los bloques contenedores, utilizamos la herencia de estilo para indicar características Markdown anidadas. En este caso, incluso cuando no hay funciones anidadas, también utilizamos estilos de párrafo con un nombre que comienza con algunas palabras especiales.

Las listas con viñetas y ordenadas también son bloques contenedores en Markdown. Su anidamiento se representa en DOM de la misma manera que para todos los demás bloques contenedores mediante herencia de estilos. Sin embargo, además, las listas en DOM tienen el formato de número correspondiente, ya sea en estilo de lista o en formato de párrafo.

Bloques en línea

Usamos el formato Font al traducir funciones Bold, Italic o ~~Tachado~~ markdown en línea.

Función Markdown Aspose.Words

Bold
{1} Font.Bold = true

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
	// Use a document builder to add content to the document.
	DocumentBuilder builder = new DocumentBuilder();

	// Make the text Bold.
	builder.Font.Bold = true;
	builder.Writeln("This text will be Bold");

view raw Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Markdown-BoldText.cs hosted with ❤ by GitHub

Italic
*italic text* Font.Italic = true

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
	// Use a document builder to add content to the document.
	DocumentBuilder builder = new DocumentBuilder();

	// Make the text Italic.
	builder.Font.Italic = true;
	builder.Writeln("This text will be Italic");

view raw Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Markdown-ItalicText.cs hosted with ❤ by GitHub

Strikethrough
~Strikethrough text~ Font.StrikeThrough = true

 // Use a document builder to add content to the document.
DocumentBuilder builder = new DocumentBuilder();

// Make the text Strikethrough.
builder.Font.Strikethrough = true;
builder.Writeln("This text will be Strikethrough");

Usamos un estilo de carácter con un nombre que comienza con la palabra InlineCode, seguido de un punto (.) opcional y varias comillas invertidas (`) para la función InlineCode. Si se omiten varias comillas graves, se utilizará una de forma predeterminada.

característica Markdown Aspose.Words

InlineCode
{1} Font.StyleName = “InlineCode[.][N]”

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
	// Use a document builder to add content to the document.
	DocumentBuilder builder = new DocumentBuilder();

	// Number of backticks is missed, one backtick will be used by default.
	Style inlineCode1BackTicks = builder.Document.Styles.Add(StyleType.Character, "InlineCode");
	builder.Font.Style = inlineCode1BackTicks;
	builder.Writeln("Text with InlineCode style with 1 backtick");

	// There will be 3 backticks.
	Style inlineCode3BackTicks = builder.Document.Styles.Add(StyleType.Character, "InlineCode.3");
	builder.Font.Style = inlineCode3BackTicks;
	builder.Writeln("Text with InlineCode style with 3 backtick");

view raw Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Markdown-InlineCode.cs hosted with ❤ by GitHub

Autolink
<scheme://domain.com>
<email@domain.com> La clase FieldHyperlink.

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
	// Use a document builder to add content to the document.
	DocumentBuilder builder = new DocumentBuilder();

	// Insert hyperlink.
	builder.InsertHyperlink("https://www.aspose.com", "https://www.aspose.com", false);
	builder.InsertHyperlink("email@aspose.com", "mailto:email@aspose.com", false);

view raw Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Markdown-Autolink.cs hosted with ❤ by GitHub

Link
{1}
{2}
PELEA
{4}) La clase FieldHyperlink.

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
	// Use a document builder to add content to the document.
	DocumentBuilder builder = new DocumentBuilder();

	// Insert hyperlink.
	builder.InsertHyperlink("Aspose", "https://www.aspose.com", false);

view raw Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Markdown-Link.cs hosted with ❤ by GitHub

Image
{1}
{2}
PELEA
{4}) La clase Shape.

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
	// Use a document builder to add content to the document.
	DocumentBuilder builder = new DocumentBuilder();

	// Insert image.
	Shape shape = new Shape(builder.Document, ShapeType.Image);
	shape.WrapType = WrapType.Inline;
	shape.ImageData.SourceFullName = "/attachment/1456/pic001.png";
	shape.ImageData.Title = "title";
	builder.InsertNode(shape);

view raw Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Markdown-Image.cs hosted with ❤ by GitHub

Bloques de contenedores

Un documento es una secuencia de bloques contenedores como encabezados, párrafos, listas, citas y otros. Los bloques de contenedores se pueden dividir en 2 clases: bloques de hojas y contenedores complejos. Los bloques de hojas solo pueden contener contenido en línea. Los contenedores complejos, a su vez, pueden contener otros bloques de contenedores, incluidos los bloques Leaf.

Bloques de hojas

La siguiente tabla muestra ejemplos del uso de bloques Markdown Leaf en Aspose.Words:

Función Markdown Aspose.Words

HorizontalRule
----- Este es un párrafo simple con una forma de Regla Horizontal correspondiente:
DocumentBuilder.InsertHorizontalRule()

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
	// Use a document builder to add content to the document.
	DocumentBuilder builder = new DocumentBuilder();

	// Insert horizontal rule.
	builder.InsertHorizontalRule();

view raw Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Markdown-HorizontalRule.cs hosted with ❤ by GitHub

ATX Heading
# H1, ## H2, ### H3… ParagraphFormat.StyleName = "Heading N", donde (1≤ N ≤ 9).
Esto se traduce en un estilo incorporado y debe seguir exactamente el patrón especificado (no se permiten sufijos ni prefijos).
De lo contrario, será sólo un párrafo normal con el estilo correspondiente.

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
	// Use a document builder to add content to the document.
	DocumentBuilder builder = new DocumentBuilder();

	// By default Heading styles in Word may have Bold and Italic formatting.
	//If we do not want to be emphasized, set these properties explicitly to false.
	builder.Font.Bold = false;
	builder.Font.Italic = false;

	builder.ParagraphFormat.StyleName = "Heading 1";
	builder.Writeln("This is an H1 tag");

view raw Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Markdown-Heading.cs hosted with ❤ by GitHub

Setext Heading
=== (si el nivel de título es 1),
--- (si el nivel de encabezado es 2) ParagraphFormat.StyleName = “SetextHeading[some suffix]”, basado en el estilo ‘Heading N’.
Si (N ≥ 2), se utilizará ‘Heading 2’; en caso contrario, ‘Heading 1’.
Se permite cualquier sufijo, pero el importador Aspose.Words utiliza los números “1” y “2” respectivamente.

 // Use a document builder to add content to the document.
DocumentBuilder builder = new DocumentBuilder();

builder.ParagraphFormat.StyleName = "Heading 1";
builder.Writeln("This is an H1 tag");

// Reset styles from the previous paragraph to not combine styles between paragraphs.
builder.Font.Bold = false;
builder.Font.Italic = false;

Style setexHeading1 = builder.Document.Styles.Add(StyleType.Paragraph, "SetextHeading1");
builder.ParagraphFormat.Style = setexHeading1;
builder.Document.Styles["SetextHeading1"].BaseStyleName = "Heading 1";
builder.Writeln("Setext Heading level 1");

builder.ParagraphFormat.Style = builder.Document.Styles["Heading 3"];
builder.Writeln("This is an H3 tag");

// Reset styles from the previous paragraph to not combine styles between paragraphs.
builder.Font.Bold = false;
builder.Font.Italic = false;

Style setexHeading2 = builder.Document.Styles.Add(StyleType.Paragraph, "SetextHeading2");
builder.ParagraphFormat.Style = setexHeading2;
builder.Document.Styles["SetextHeading2"].BaseStyleName = "Heading 3";

// Setex heading level will be reset to 2 if the base paragraph has a Heading level greater than 2.
builder.Writeln("Setext Heading level 2");

Indented Code ParagraphFormat.StyleName = “IndentedCode[some suffix]”

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
	// Use a document builder to add content to the document.
	DocumentBuilder builder = new DocumentBuilder();

	Style indentedCode = builder.Document.Styles.Add(StyleType.Paragraph, "IndentedCode");
	builder.ParagraphFormat.Style = indentedCode;
	builder.Writeln("This is an indented code");

view raw Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Markdown-IndentedCode.cs hosted with ❤ by GitHub

Fenced Code

``` c#
if ()
then
else
```

ParagraphFormat.StyleName = “FencedCode[.][info string]”
El [.] y el [info string] son opcionales.

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
	// Use a document builder to add content to the document.
	DocumentBuilder builder = new DocumentBuilder();

	Style fencedCode = builder.Document.Styles.Add(StyleType.Paragraph, "FencedCode");
	builder.ParagraphFormat.Style = fencedCode;
	builder.Writeln("This is an fenced code");

	Style fencedCodeWithInfo = builder.Document.Styles.Add(StyleType.Paragraph, "FencedCode.C#");
	builder.ParagraphFormat.Style = fencedCodeWithInfo;
	builder.Writeln("This is a fenced code with info string");

view raw Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Markdown-FencedCode.cs hosted with ❤ by GitHub

Contenedores complejos

La siguiente tabla muestra ejemplos del uso de contenedores complejos Markdown en Aspose.Words:

característica Markdown Aspose.Words

Quote
> quote,
>> nested quote ParagraphFormat.StyleName = “Quote[some suffix]”
El sufijo en el nombre del estilo es opcional, pero el importador Aspose.Words utiliza los números ordenados 1, 2, 3,…. en caso de comillas anidadas.
El anidamiento se define mediante los estilos heredados.

 // Use a document builder to add content to the document.
DocumentBuilder builder = new DocumentBuilder();

// By default a document stores blockquote style for the first level.
builder.ParagraphFormat.StyleName = "Quote";
builder.Writeln("Blockquote");

// Create styles for nested levels through style inheritance.
Style quoteLevel2 = builder.Document.Styles.Add(StyleType.Paragraph, "Quote1");
builder.ParagraphFormat.Style = quoteLevel2;
builder.Document.Styles["Quote1"].BaseStyleName = "Quote";
builder.Writeln("1. Nested blockquote");

BulletedList
- Item 1
- Item 2
PELEA
- Item 2b Las listas con viñetas se representan mediante numeración de párrafos:
ListFormat.ApplyBulletDefault()
Puede haber 3 tipos de listas con viñetas. Sólo son diferencias en un formato de numeración del primer nivel. Estos son: ‘-’, ‘+’ o ‘*’ respectivamente.

	// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
	// Use a document builder to add content to the document.
	DocumentBuilder builder = new DocumentBuilder();

	builder.ListFormat.ApplyBulletDefault();
	builder.ListFormat.List.ListLevels[0].NumberFormat = "-";

	builder.Writeln("Item 1");
	builder.Writeln("Item 2");

	builder.ListFormat.ListIndent();

	builder.Writeln("Item 2a");
	builder.Writeln("Item 2b");

view raw Examples-DocsExamples-DocsExamples-Programming with Documents-Working with Markdown-BulletedList.cs hosted with ❤ by GitHub

OrderedList
1. Item 1
2. Item 2
PELEA
2) Item 2b Las listas ordenadas se representan mediante numeración de párrafos:
ListFormat.ApplyNumberDefault()
Puede haber 2 marcadores de formato numérico: ‘.’ y ‘)’. El marcador predeterminado es ‘.’.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.ListFormat.ApplyBulletDefault();
builder.ListFormat.List.ListLevels[0].NumberFormat = $"{(char) 0}.";
builder.ListFormat.List.ListLevels[1].NumberFormat = $"{(char) 1}.";

builder.Writeln("Item 1");
builder.Writeln("Item 2");

builder.ListFormat.ListIndent();

builder.Writeln("Item 2a");
builder.Writeln("Item 2b");

Mesas

Aspose.Words también permite traducir tablas a DOM, como se muestra a continuación:

característica Markdown Aspose.Words

Table
un | b
-|-
c|d Clases Table, Row y Cell.

característica Markdown	Aspose.Words
`Table` `un \| b` `-\|-` `c\|d`	Clases Table, Row y Cell.
`// Use a document builder to add content to the document. DocumentBuilder builder = new DocumentBuilder(); // Add the first row. builder.InsertCell(); builder.Writeln("a"); builder.InsertCell(); builder.Writeln("b"); // Add the second row. builder.InsertCell(); builder.Writeln("c"); builder.InsertCell(); builder.Writeln("d");`

 // Use a document builder to add content to the document.
DocumentBuilder builder = new DocumentBuilder();

// Add the first row.
builder.InsertCell();
builder.Writeln("a");
builder.InsertCell();
builder.Writeln("b");

// Add the second row.
builder.InsertCell();
builder.Writeln("c");
builder.InsertCell();
builder.Writeln("d");

Ver también

Trabajar con funciones Markdown

Modelo de objetos de documento Aspose.Words (DOM) en C# Descripción general del generador de documentos en C#