Převést dokument na Markdown

Markdown je populární formát používaný k připsání textu a jeho další konverzi na HTML, PDF, DOCX nebo jiné formáty. Mnoho vývojářů si tento formát vybere pro psaní dokumentace, přípravu článků pro publikaci na blogech, popis projektů a tak dále.

Markdown je tak populární, protože je snadné pracovat s tímto formátem, stejně jako to může být zcela jednoduše převedeny na jiné formáty. Z tohoto důvodu Aspose.Words poskytuje schopnost převést dokument v jakýkoli podporovaný formát zatížení až Markdown a naopak. Aspose.Words také podporuje nejpopulárnější uložit formáty.

Nyní funkce pro práci s Markdown formát je aktivně vyvíjen tak, aby vám více příležitostí pro pohodlnou a pohodlnou práci s dokumenty.

Převést dokument

Převést dokument na Markdown,? stačí načíst dokument v jakémkoli podporovaném formátu nebo vytvořit nový programově. Pak musíte uložit dokument do Markdown formát.

Následující příklad kódu ukazuje, jak převést DOCX na Markdown:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.writeln("Some text!")
doc.save(docs_base.artifacts_dir + "BaseConversions.docx_to_markdown.md")

Můžete také zadat fyzickou složku, ve které chcete uložit obrázky při exportu dokumentu do Markdown formát. Ve výchozím nastavení Aspose.Words Ukládá obrázky ve stejné složce, kde je uložen soubor s dokumentem, ale můžete toto chování přepsat pomocí images_folder majetek.

Zadání složky přes images_folder je také užitečné, pokud uložíte dokument do potoka a Aspose.Words nemá složku pro ukládání obrázků.

Pokud je uvedeno images_folder neexistuje, bude vytvořen automaticky.

Následující příklad kódu ukazuje, jak zadat složku pro obrázky při uložení dokumentu do streamu:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "Image bullet points.docx")
saveOptions = aw.saving.MarkdownSaveOptions()
saveOptions.images_folder = docs_base.artifacts_dir + "Images"
doc.save(docs_base.artifacts_dir + "WorkingWithMarkdownSaveOptions.set_images_folder.md", saveOptions)

Zadejte možnosti uložení při převodu na Markdown

Aspose.Words poskytuje schopnost používat MarkdownSaveOptions třída pracovat s pokročilými možnostmi při ukládání dokumentu na Markdown formát. Většina nemovitostí zdědí nebo přetížení vlastnosti, které již existují v rámci jiných aspose.words.saving třídy. Kromě nich, řada vlastností, které jsou specifické pro Markdown byl také přidán formát. Například: table_content_alignment vlastnost kontrolovat sladění obsahu v tabulkách nebo images_folder k ovládání, kde jsou obrázky uloženy při převodu dokumentu na Markdown formát.

Podporované Markdown Vlastnosti

Aspose.Words v současné době podporuje následující Markdown funkce, které většinou sledují CommonMark specifikace Aspose.Words API a jsou reprezentovány jako vhodné styly nebo přímé formátování:

  • Do čísel patří odstavce čísla 1 a 6
  • Blockquotes jsou odstavce s “Quote” v názvu stylu
  • IndentedCode jsou odstavce s “IndentedCode” ve stylu názvu
  • Fenced Kód jsou odstavce s “FencedCode” v názvu stylu
  • InlineCode jsou běží s “InlineCode” v Font název stylu
  • Horizontální pravidla jsou odstavce s HorizontalRule tvar
  • Odvážný důraz
  • Italický důraz
  • StrikeThrough formatting
  • Seznamy jsou číslovány nebo zastřeleny odstavce
  • Tabulky jsou zastoupeny Table třída
  • Odkazy jsou zastoupeny jako FieldHyperlink třída

Následující příklad ukazuje, jak vytvořit dokument s některými styly a uložit jej Markdown:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
# Specify the "Heading 1" style for the paragraph.
builder.paragraph_format.style_name = "Heading 1"
builder.writeln("Heading 1")
# Reset styles from the previous paragraph to not combine styles between paragraphs.
builder.paragraph_format.style_name = "Normal"
# Insert horizontal rule.
builder.insert_horizontal_rule()
# Specify the ordered list.
builder.insert_paragraph()
builder.list_format.apply_number_default()
# Specify the Italic emphasis for the text.
builder.font.italic = True
builder.writeln("Italic Text")
builder.font.italic = False
# Specify the Bold emphasis for the text.
builder.font.bold = True
builder.writeln("Bold Text")
builder.font.bold = False
# Specify the StrikeThrough emphasis for the text.
builder.font.strike_through = True
builder.writeln("StrikeThrough Text")
builder.font.strike_through = False
# Stop paragraphs numbering.
builder.list_format.remove_numbers()
# Specify the "Quote" style for the paragraph.
builder.paragraph_format.style_name = "Quote"
builder.writeln("A Quote block")
# Specify nesting Quote.
nestedQuote = doc.styles.add(aw.StyleType.PARAGRAPH, "Quote1")
nestedQuote.base_style_name = "Quote"
builder.paragraph_format.style_name = "Quote1"
builder.writeln("A nested Quote block")
# Reset paragraph style to Normal to stop Quote blocks.
builder.paragraph_format.style_name = "Normal"
# Specify a Hyperlink for the desired text.
builder.font.bold = True
# Note, the text of hyperlink can be emphasized.
builder.insert_hyperlink("Aspose", "https:#www.aspose.com", False)
builder.font.bold = False
# Insert a simple table.
builder.start_table()
builder.insert_cell()
builder.write("Cell1")
builder.insert_cell()
builder.write("Cell2")
builder.end_table()
# Save your document as a Markdown file.
doc.save(docs_base.artifacts_dir + "WorkingWithMarkdown.create_markdown_document.md")

Výsledek tohoto příkladu kódu je uveden níže.

markdown-example-aspose-words-net

Užitečné tipy

Existuje několik nuance a zajímavé případy, poté, co se naučil, které můžete pracovat s Markdown soubory flexibilnější a pohodlnější. Existuje například schopnost používat:

  • SetextHeading, který vám umožní vytvořit víceřádkové okruhy v Markdown,? zatímco pravidelné okruhy v Markdown může být jen jednořádka. SetextHeading je založen na stylu “Heading N” a jeho úroveň může být pouze 1 nebo 2. Je-li N v položce “hlava N” větší nebo rovno 2, je odpovídající SetextHeading založen na “hlavě 2,” jinak na “hlavě 1.”
  • Různé značky pro první úroveň kulkovaných seznamů ("-", “+” nebo “*,” výchozí značka je ‘a’ - ‘a’.) a různé typy číslování pro objednané seznamy ("." nebo “) ,” výchozí značka je “.").