Konwertuj dokument na Markdown

Markdown to popularny format używany do oznaczania tekstu i jego dalszej konwersji do formatu HTML, PDF, DOCX lub innego. Wielu programistów wybiera ten format do pisania dokumentacji, przygotowywania artykułów do publikacji na blogach, opisywania projektów i tak dalej.

Markdown jest tak popularny, ponieważ łatwo jest pracować z tym formatem, a także można go po prostu przekonwertować na inne formaty. Z tego powodu Aspose.Words umożliwia konwersję dokumentu w formacie dowolny obsługiwany format ładowania do Markdown i odwrotnie – Aspose.Words obsługuje także najpopularniejszy format zapisz formaty.

Obecnie aktywnie rozwijana jest funkcjonalność pracy z formatem Markdown, aby zapewnić więcej możliwości wygodnej i komfortowej pracy z dokumentami.

Konwertuj dokument

Aby przekonwertować dokument do formatu Markdown wystarczy załadować dokument w dowolnym obsługiwanym formacie lub programowo utworzyć nowy. Następnie należy zapisać dokument w formacie Markdown.

Poniższy przykład kodu pokazuje, jak przekonwertować DOCX na Markdown:

Możesz także określić folder fizyczny, w którym chcesz zapisywać obrazy podczas eksportowania dokumentu do formatu Markdown. Domyślnie Aspose.Words zapisuje obrazy w tym samym folderze, w którym zapisywany jest plik dokumentu, ale można zmienić to zachowanie, korzystając z właściwości images_folder.

Określenie folderu za pomocą images_folder jest również przydatne, jeśli zapisujesz dokument w strumieniu, a Aspose.Words nie ma folderu do zapisywania obrazów.

Jeśli określony images_folder nie istnieje, zostanie utworzony automatycznie.

Poniższy przykład kodu pokazuje, jak określić folder dla obrazów podczas zapisywania dokumentu w strumieniu:

Określ opcje zapisu podczas konwersji do formatu Markdown

Aspose.Words zapewnia możliwość wykorzystania klasy MarkdownSaveOptions do pracy z zaawansowanymi opcjami podczas zapisywania dokumentu w formacie Markdown. Większość właściwości dziedziczy lub przeciąża właściwości, które już istnieją w innych klasach aspose.words.saving. Oprócz nich dodano także szereg właściwości specyficznych dla formatu Markdown. Na przykład właściwość table_content_alignment do kontrolowania wyrównania treści w tabelach lub images_folder do kontrolowania miejsca zapisywania obrazów po konwersji dokumentu do formatu Markdown.

Obsługiwane funkcje Markdown

Aspose.Words obsługuje obecnie następujące funkcje Markdown, które w większości są zgodne ze specyfikacją CommonMark w Aspose.Words API i są reprezentowane jako odpowiednie style lub formatowanie bezpośrednie:

• Nagłówki to akapity ze stylami Nagłówek 1 – Nagłówek 6
• Cytaty blokowe to akapity zawierające “Cytat” w nazwie stylu
• IndentedCode to akapity zawierające “IndentedCode” w nazwie stylu
• FencedCode to akapity zawierające “FencedCode” w nazwie stylu
• InlineCode jest uruchamiany z “InlineCode” w nazwie stylu Font
• Linie poziome to akapity w kształcie HorizontalRule
• Odważne podkreślenie
• Podkreślenie kursywą
• Formatowanie przekreślone
• Listy to akapity numerowane lub wypunktowane
• Tabele są reprezentowane przez klasę Table
• Linki są reprezentowane jako klasa FieldHyperlink

Poniższy przykład pokazuje, jak utworzyć dokument z pewnymi stylami i zapisać go w formacie Markdown:

Wynik tego przykładowego kodu pokazano poniżej.

Przydatne porady

Istnieje kilka niuansów i interesujących przypadków, po dowiedzeniu się, które z plików Markdown można pracować bardziej elastycznie i wygodnie. Przykładowo istnieje możliwość wykorzystania:

• SetextHeading, który umożliwia tworzenie nagłówków wieloliniowych w Markdown, podczas gdy zwykłe nagłówki w Markdown mogą być tylko jednowierszowe. SetextHeading opiera się na stylu “Nagłówek N”, a jego poziom może wynosić tylko 1 lub 2. Jeśli N w “Nagłówku N” jest większe lub równe 2, wówczas odpowiadający mu styl SetextHeading jest oparty na “Nagłówku 2”, w przeciwnym razie na “Nagłówek 1”.
• Różne znaczniki dla pierwszego poziomu list punktowanych ("-", “+” lub “*”, domyślnym znacznikiem jest “-”.) i różne typy numeracji dla list uporządkowanych (""." lub “)”, domyślnym znacznikiem jest “.").