Перетворення документа в Markdown

Markdown є популярним форматом, який використовується для позначення тексту та його подальшого перетворення в HTML, PDF, DOCX або інші формати. Багато розробників вибирають цей формат для написання документації, підготовка статей до публікації на блогах, опис проектів, тощо.

Markdown є дуже популярним, тому що він легко працювати з цим форматом, а також він може бути досить просто перетворений на інші формати. З цієї причини, Aspose.Words надає можливість конвертувати документ у будь-який підтримуваний формат навантаження до Markdown і навпаки – Aspose.Words також підтримує найбільш популярні зберігати форматий

Тепер функціональність для роботи з Markdown Для зручності та комфортної роботи з документами активно розроблені формати.

Конвертувати документ

Для перетворення документа в Markdown, > Вам просто потрібно завантажити документ в будь-якому форматі підтримки або створити нову програму. Потім потрібно зберегти документ, щоб зберегти Markdown Формат.

Приклад наступного коду показує, як перетворити DOCX в Markdown:

.NET

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
// 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 зберігає зображення в тій же папці, де збережено файл документа, але ви можете перевизначити цю поведінку за допомогою ImagesFolder майно.

Вкажіть папку через ImagesFolder також корисно, якщо ви зберігаєте документ на потік і Aspose.Words не має папки для збереження зображень.

Якщо зазначено ImagesFolder не існує, він буде створений автоматично.

Приклад наступного коду показує, як вказати папку для зображень при збереженні документа в потік:

.NET

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

MarkdownSaveOptions so = new MarkdownSaveOptions();
so.ImagesFolder = dataDir + "\\Images";
            
using (MemoryStream stream = new MemoryStream())
    doc.Save(stream, so);

Вкажіть параметри збереження при конвертації Markdown

Aspose.Words забезпечує можливість використання MarkdownSaveOptions клас для роботи з розширеними опціями при збереженні документа Markdown Формат. Більшість властивостей є спадковими або перевантажувальні властивості, які вже існують в інших країнах Aspose.Words.Saving Ім’я Крім них, ряд властивостей, які специфічні для них 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:

.NET

// 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);

// Specify the "Heading 1" style for the paragraph.
builder.InsertParagraph();
builder.ParagraphFormat.StyleName = "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.ParagraphFormat.StyleName = "Normal";
builder.Font.Italic = true;
builder.Write("Italic Text");
// Reset styles from the previous paragraph to not combine styles between paragraphs.
builder.Italic = 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("example.md");

Приклад даного коду показано нижче.

Корисні поради

Є кілька нюансів і цікавих випадків, які навчилися працювати з Markdown фото більш гнучко і зручно. Наприклад, існує можливість використання:

• SetextHeading, що дозволяє створювати багатолінійні заголовки в Markdown, > при регулярних заголовках Markdown може бути тільки одноканальним. SetextHeading базується на стилі “Хайд Н” і його рівень може бути тільки 1 або 2. Якщо N в “Хайдінг N” більше або дорівнює 2, то відповідне SetextHeading базується на “Хайдинг 2”, інакше на “Хайдінг 1”.
• Різні маркери для першого рівня бюлетенів ("-", “+” або “*”, маркер за замовчуванням - “-”.