Перетворення документа в 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 забезпечує можливість використання MarkdownSaveOptions клас для роботи з розширеними опціями при збереженні документа Markdown Формат. Крім інших спадкових або перевантажувальних властивостей, ряд властивостей, які специфічні для Markdown Додано формат. Наприклад, TableContentAlignment майно для управління вирівнюванням вмісту в таблицях або ImageSavingCallback і ImagesFolder щоб контролювати, як зображення зберігаються при конвертації документа в Markdown Формат.

Підтримувані Markdown Особливості

Aspose.Words В даний час ми підтримуємо наступні дії Markdown особливості, які переважно слідують CommonMark специфікація в Aspose.Words API і представлені як відповідні стилі або прямі форматування:

• Заголовки є абзаци з заголовуванням 1 - Заголовок 6 стилів
• Блокноти є абзаци з “Quote” в назві стилю
• ВизначеніКод є абзаци з “IndentedCode” в назві стилю
• Зареєстрований Код є абзаци з “FencedCode” в назві стилю
• InlineCode працює з “InlineCode” в Font Назва стилю
• Горизонтальні правила є абзаци з HorizontalRule форма
• Золотий акцент
• Цілий акцент
• Форматування удару
• Списки занурюються або приклеюються абзаци
• Столи представлені з 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 базується на стилі “Хайд Н” і його рівень може бути тільки 1 або 2. Якщо N в “Хайдінг N” більше або дорівнює 2, то відповідне SetextHeading базується на “Хайдинг 2”, інакше на “Хайдінг 1”.
• Різні маркери для першого рівня бюлетенів ("-", “+” або “*”, маркер за замовчуванням - “-”.