Werken met Markdown Kenmerken
Dit onderwerp bespreekt hoe te implementeren Markdown functies gebruiken Aspose.Words. Markdown is een eenvoudige manier om platte tekst te formatteren die gemakkelijk kan worden omgezet naar HTML. Aspose.Words ondersteunt het volgende Markdown kenmerken:
- Rubrieken
- Blockquotes
- Horizontale regels
- Vet accent
- Cursief accent
De Markdown functie implementatie volgt meestal de CommonMark
specificatie in Aspose.Words API en alle functies zijn weergegeven als overeenkomstige stijlen of directe opmaak. Wat betekent dat
- Vet en Cursief zijn vertegenwoordigd als
Font.Bold
enFont.Italic
- Rubrieken zijn paragrafen met rubriek 1 - Rubriek 6 stijlen
- Citaten zijn paragrafen met “Citere” in de stijlnaam
- Horizontale regel is een paragraaf met horizontale regel vorm.
Markdown Document met Emphases
Deze sectie laat zien hoe u een markdown document met onderstaande nadruk:
Markdown treats asterisks (*) and underscores (_) as indicators of emphasis.
You can write **bold** or *italic* text.
You can also write ***BoldItalic*** text.
De volgende code knipsel kan worden gebruikt om het bovenstaande gegeven te produceren markdown document.
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET | |
Document doc = new Document(); | |
DocumentBuilder builder = new DocumentBuilder(doc); | |
builder.Writeln("Markdown treats asterisks (*) and underscores (_) as indicators of emphasis."); | |
builder.Write("You can write "); | |
builder.Font.Bold = true; | |
builder.Write("bold"); | |
builder.Font.Bold = false; | |
builder.Write(" or "); | |
builder.Font.Italic = true; | |
builder.Write("italic"); | |
builder.Font.Italic = false; | |
builder.Writeln(" text. "); | |
builder.Write("You can also write "); | |
builder.Font.Bold = true; | |
builder.Font.Italic = true; | |
builder.Write("BoldItalic"); | |
builder.Font.Bold = false; | |
builder.Font.Italic = false; | |
builder.Write("text."); | |
builder.Document.Save("EmphasesExample.md"); |
Markdown Document met kopjes
Deze sectie laat zien hoe u een markdown document met onderstaande rubrieken:
The following produces headings:
# Heading1
## Heading2
### Heading3
#### Heading4
##### Heading5
###### Heading6
# **Bold Heading1**
De volgende code knipsel kan worden gebruikt om het bovenstaande gegeven te produceren markdown document.
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET | |
Document doc = new Document(); | |
DocumentBuilder builder = new DocumentBuilder(doc); | |
// By default Heading styles in Word may have bold and italic formatting. | |
// If we do not want text to be emphasized, set these properties explicitly to false. | |
builder.Font.Bold = false; | |
builder.Font.Italic = false; | |
builder.Writeln("The following produces headings:"); | |
builder.ParagraphFormat.Style = doc.Styles["Heading 1"]; | |
builder.Writeln("Heading1"); | |
builder.ParagraphFormat.Style = doc.Styles["Heading 2"]; | |
builder.Writeln("Heading2"); | |
builder.ParagraphFormat.Style = doc.Styles["Heading 3"]; | |
builder.Writeln("Heading3"); | |
builder.ParagraphFormat.Style = doc.Styles["Heading 4"]; | |
builder.Writeln("Heading4"); | |
builder.ParagraphFormat.Style = doc.Styles["Heading 5"]; | |
builder.Writeln("Heading5"); | |
builder.ParagraphFormat.Style = doc.Styles["Heading 6"]; | |
builder.Writeln("Heading6"); | |
// Note, emphases are also allowed inside Headings: | |
builder.Font.Bold = true; | |
builder.ParagraphFormat.Style = doc.Styles["Heading 1"]; | |
builder.Writeln("Bold Heading1"); | |
doc.Save(dataDir + "HeadingsExample.md"); |
Markdown Document met blokquotes
Deze sectie laat zien hoe u een markdown document met blokquotes zoals hieronder aangegeven:
We support blockquotes in Markdown:
>*Lorem*
>*ipsum*
>The quotes can be of any level and can be nested:
>>>Quote level 3
>>>
>>>>Nested quote level 4
>
>*Back to first level*
>### Headings are allowed inside Quotes
>
De volgende code knipsel kan worden gebruikt om het bovenstaande gegeven te produceren markdown document.
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET | |
Document doc = new Document(); | |
DocumentBuilder builder = new DocumentBuilder(doc); | |
builder.Writeln("We support blockquotes in Markdown:"); | |
builder.ParagraphFormat.Style = doc.Styles["Quote"]; | |
builder.Writeln("Lorem"); | |
builder.Writeln("ipsum"); | |
builder.ParagraphFormat.Style = doc.Styles["Normal"]; | |
builder.Writeln("The quotes can be of any level and can be nested:"); | |
Style quoteLevel3 = doc.Styles.Add(StyleType.Paragraph, "Quote2"); | |
builder.ParagraphFormat.Style = quoteLevel3; | |
builder.Writeln("Quote level 3"); | |
Style quoteLevel4 = doc.Styles.Add(StyleType.Paragraph, "Quote3"); | |
builder.ParagraphFormat.Style = quoteLevel4; | |
builder.Writeln("Nested quote level 4"); | |
builder.ParagraphFormat.Style = doc.Styles["Quote"]; | |
builder.Writeln(); | |
builder.Writeln("Back to first level"); | |
Style quoteLevel1WithHeading = doc.Styles.Add(StyleType.Paragraph, "Quote Heading 3"); | |
builder.ParagraphFormat.Style = quoteLevel1WithHeading; | |
builder.Write("Headings are allowed inside Quotes"); | |
doc.Save(dataDir + "QuotesExample.md"); |
Markdown Document met horizontale regel
Deze sectie laat zien hoe u een markdown document met horizontaal Regel als volgt:
We support Horizontal rules (Thematic breaks) in Markdown:
-----
De volgende code knipsel kan worden gebruikt om het bovenstaande gegeven te produceren markdown document.
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET | |
// Initialize document. | |
Document doc = new Document(); | |
DocumentBuilder builder = new DocumentBuilder(doc); | |
builder.Writeln("Insert a horizontal rule shape into the document."); | |
builder.InsertHorizontalRule(); | |
dataDir = dataDir + "DocumentBuilder.InsertHorizontalRule_out.doc"; | |
doc.Save(dataDir); |
Lezen van een Markdown Document
De volgende code knipsel laat zien hoe u een markdown document.
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET | |
// This is Markdown document that was produced in example of UC3. | |
Document doc = new Document(dataDir + "QuotesExample.md"); | |
// Let's remove Heading formatting from a Quote in the very last paragraph. | |
Paragraph paragraph = doc.FirstSection.Body.LastParagraph; | |
paragraph.ParagraphFormat.Style = doc.Styles["Quote"]; | |
doc.Save(dataDir + "QuotesModifiedExample.md"); |
Specificeer Markdown Opties opslaan
Aspose.Words API levert MarkdownSaveOptions klasse om extra opties op te geven tijdens het opslaan van een document in de Markdown formaat.
Het volgende voorbeeld van de code liet zien hoe verschillende Markdown opties opslaan.
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET | |
DocumentBuilder builder = new DocumentBuilder(); | |
builder.Writeln("Some text!"); | |
// specify MarkDownSaveOptions | |
MarkdownSaveOptions saveOptions = (MarkdownSaveOptions)SaveOptions.CreateSaveOptions(SaveFormat.Markdown); | |
builder.Document.Save(dataDir + "TestDocument.md", saveOptions); |
Inhoud in de tabel uitlijnen tijdens het exporteren naar Markdown
Aspose.Words API levert TableContentAlignment Lijst waarin uitlijningsrichtingen worden gedefinieerd om de inhoud in tabellen op elkaar af te stemmen tijdens de export naar de Markdown document. Het volgende voorbeeld van code laat zien hoe inhoud in de tabel moet worden uitgelijnd.
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET | |
DocumentBuilder builder = new DocumentBuilder(); | |
// Create a new table with two cells. | |
builder.InsertCell(); | |
builder.ParagraphFormat.Alignment = ParagraphAlignment.Right; | |
builder.Write("Cell1"); | |
builder.InsertCell(); | |
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center; | |
builder.Write("Cell2"); | |
MarkdownSaveOptions saveOptions = new MarkdownSaveOptions(); | |
// Makes all paragraphs inside table to be aligned to Left. | |
saveOptions.TableContentAlignment = TableContentAlignment.Left; | |
builder.Document.Save(dataDir + "left.md", saveOptions); | |
// Makes all paragraphs inside table to be aligned to Right. | |
saveOptions.TableContentAlignment = TableContentAlignment.Right; | |
builder.Document.Save(dataDir + "right.md", saveOptions); | |
// Makes all paragraphs inside table to be aligned to Center. | |
saveOptions.TableContentAlignment = TableContentAlignment.Center; | |
builder.Document.Save(dataDir + "center.md", saveOptions); | |
// Makes all paragraphs inside table to be aligned automatically. | |
// The alignment in this case will be taken from the first paragraph in corresponding table column. | |
saveOptions.TableContentAlignment = TableContentAlignment.Auto; | |
builder.Document.Save(dataDir + "auto.md", saveOptions); |