文書をMarkdownに変換する

Markdownはテキストをマークアップするために使用される一般的な形式であり、さらに次のように変換されますHTML, PDF, DOCX, または他のフォーマット。 多くの開発者は、ドキュメントの作成、ブログへの公開のための記事の準備、プロジェクトの説明などのためにこの形式を選択します。

Markdownは、この形式で作業するのが簡単であるだけでなく、他の形式に簡単に変換できるため、非常に人気があります。 このため、Aspose.Wordsはサポートされているロード形式の文書をMarkdownに、またその逆に変換する機能を提供します–Aspose.Wordsは最も人気のある形式の保存もサポートします。

現在、Markdown形式で作業するための機能が積極的に開発されており、文書を便利で快適に作業する機会が増えています。

文書をMarkdownに変換する

ドキュメントをMarkdownに変換するには、サポートされている任意の形式でドキュメントを読み込むか、プログラムで新しい形式を作成するだけです。 次に、文書をMarkdown形式で保存する必要があります。

次のコード例は、DOCXをMarkdownに変換する方法を示しています:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
// Load the document from disk.
Document doc = new Document(dataDir + "Test.docx");

// Save the document to Markdown format.
doc.save(dataDir + "SaveDocx2Markdown.md");

Markdownに変換するときに保存オプションを指定します

Aspose.Wordsは、文書をMarkdown形式で保存するときに、高度なオプションを操作するためにMarkdownSaveOptionsクラスを使用する機能を提供します。 他の継承またはオーバーロードのプロパティに加えて、Markdown形式に固有のいくつかのプロパティも追加されました。 たとえば、テーブル内のコンテンツの配置を制御するTableContentAlignmentプロパティや、文書をMarkdown形式に変換する際に画像を保存する方法を制御するImageSavingCallbackとImagesFolderプロパティ

サポートされているMarkdown機能

Aspose.Wordsは現在、次のMarkdown機能をサポートしていますが、主にAspose.WordsAPIのCommonMark仕様に従い、適切なスタイルまたは直接書式設定として表されます:

• 見出しはHeading 1–Heading 6スタイルの段落です
• Blockquotesは、スタイル名に"Quote"が付いた段落です
• IndentedCodeはスタイル名に"IndentedCode"を含む段落です
• FencedCodeはスタイル名に"FencedCode"を含む段落です
• InlineCodeは、Fontスタイル名に"InlineCode"が付いた実行です
• 水平ルールはHorizontalRuleの形をした段落です
• 大胆な強調
• 斜体強調
• StrikeThrough書式設定
• リストには番号または箇条書きの段落が付いています
• テーブルはTableクラスで表されます
• リンクはFieldHyperlinkクラスとして表されます

次の例は、いくつかのスタイルを持つドキュメントを作成してMarkdownに保存する方法を示しています:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Specify the "Heading 1" style for the paragraph.
builder.insertParagraph();
builder.getParagraphFormat().setStyleName("Heading 1");
builder.write("Heading 1");

// Specify the Italic emphasis for the paragraph.
builder.insertParagraph();
// Reset styles from the previous paragraph to not combine styles between paragraphs.
builder.getParagraphFormat().setStyleName("Normal");
builder.getFont().setItalic(true);
builder.write("Italic Text");
// Reset styles from the previous paragraph to not combine styles between paragraphs.
builder.setItalic(false);

// Specify a Hyperlink for the desired text.
builder.insertParagraph();
builder.insertHyperlink("Aspose","https://www.aspose.com", false);
builder.write("Aspose");

// Save your document as a Markdown file.
doc.save(dataDir + "example.md");

このコード例の結果を以下に示します。

便利なヒント

いくつかのニュアンスと興味深いケースがあり、Markdownファイルをより柔軟かつ便利に扱うことができることを学びました。 たとえば、次を使用する機能があります:

• SetextHeadingはMarkdownに複数行の見出しを作成することができますが、Markdownの通常の見出しは単一行のみにすることができます。 SetextHeadingは"見出しN"スタイルに基づいており、そのレベルは1または2のみです。 “見出しN"のNが2以上の場合、対応するSetextHeadingは"Heading 2"に基づいており、そうでない場合は"Heading 1"に基づいています。
• 箇条書きリストの最初のレベル("-"、"+"、または”*")の異なるマーカーは、デフォルトのマーカーは"-“です。(”.“または”)“の場合、デフォルトのマーカーは”.“です)。