Procesorul de fișiere Aspose.Words Markdown pentru .NET

Aspose.Words Markdown File Processor pentru .NET permite dezvoltatorilor să creeze, încărcați, editați și salvați documentele de marcat în mod programat folosind același model de obiect familiar ca Aspose!Word. Acesta este conceput pentru generarea dinamică a conținutului, automatizarea documentării și fluxurile de lucru de transformare în care Marcat este formatul preferat.

Instalare și setare

  • Instalarea pachetului NuGet Aspose.Words.
  • Încercați să aplicați licența ( Licență măsurată ).
  • Adăugați la Aspose.Words Spatiul pentru proiectul tau.
  • Pentru obiectivele de cadru și setarea pachetului, a se vedea Ghid de instalare .

Platforme suportate: Windows, Linux, macOS, OS mobil cu .NET Framework, .Net Core/5/6+, sau Mono.IDE: Visual Studio 2010–2022, Xamarin, MonoDevelop.

Start rapid: Creați un fișier Markdown 

var doc = new Document();
var builder = new DocumentBuilder(doc);

// Insert a horizontal rule (renders as '-----' in Markdown)
builder.InsertHorizontalRule();

doc.Save("Output.md");

Caracteristici și funcționalitate

Crearea documentului

  • Generarea noilor .md Fișierele sunt dinamice.
  • Introduceți titluri, paragrafe, liste, tabele și metadata.
  • Setă proprietăți la nivel de document, cum ar fi titlul, autorul și etichetele.

Încărcarea documentelor

  • încărcătura existentă .md fișierele din discuri, fluxuri sau lanțuri.
  • Conservă structura: titluri, tabele, listele și formatarea inline.
  • Menține blocuri de cod, metadate și link-uri în stil de referință.

DOM (Document Object Model) – modelul obiectului documentar)

  • Acces și manipulare:

  • Paragrafele și cursurile (bold, italic, strict, cod inline)

  • Cuvânt cheie (H1 – H6)

  • Listele (comandat / nereglementat, născut)

  • Tabelele, roțile și celulele

  • CodeBlock & InlineCod noduri

  • Links & Images (cu alt text, titluri și URL-uri)

Text și formatare inline

  • Aplicați sintaza Markdown prin atributele de rulare.
  • Ajută-te să fii curajos (**), în limba italiană (*), în mod strict (~~), și codul inline (```).
  • Manează formatarea prin paragrafele și listele în mod fiabil.

Ședințe și secțiuni

  • Adaptarea programatică a nivelului de conducere.
  • Reorganizarea secțiunilor pentru generația TOC.
  • Se împart sau se amestecă blocuri bazate pe titlu.

Listele și listele nestate

  • Compania a fost comandată (1., 2.) sau în mod necorespunzător (-, *) în listă.
  • Convertați paragrafele în elemente de listă.
  • Introduceți, eliminați sau transformați tipurile de listă în mod dinamic.

Tables

  • Creați și manipulați tabelele de marcat GitHub.
  • Introduceți rânduri / coloane, fuzionați celule și editați conținut.
  • Suport pentru celule multiline cu formatare păstrată.

Imagini și link-uri

  • Adăugați sau actualizați imagini de referință (![alt](url "title")).
  • Încărcați link-uri ([text](url "title")).
  • Susține sintaxul de link inline și de referință.

Blocuri de cod

  • Introduceți blocuri de cod cu etichete lingvistice (`csharp).
  • Gestionați spaniul de cod inline cu auto-escapare.
  • Modificare a stilurilor de fântână (bacticuri sau tilde).

Metadata și Front-Matter

  • Citeste/scrie YAML sau TOML front-matter.
  • Mențineți metadata pentru generatorii de site static (Hugo, Jekyll, etc.).

economisirea si exportul

  • salvare înapoi la .md Cu opțiuni:

  • Conservați spațiul alb și comentariile.

  • Normalizează indentarea și terminarea liniei.

  • Încărcați sau actualizați metadata cu callbacks.

Exemple avansate

Etichetă: existent markdown 

var doc = new Document("Quotes.md");
var builder = new DocumentBuilder(doc);

builder.MoveToDocumentEnd();
builder.ParagraphFormat.ClearFormatting();
builder.Writeln("\n");

// Insert inline code with backticks
var inlineCodeStyle = doc.Styles.Add(StyleType.Character, "InlineCode.3");
builder.Font.Style = inlineCodeStyle;
builder.Writeln("Produced by Aspose.Words Markdown Processor.");

doc.Save("UpdatedQuotes.md");

Introduceți codul bloc 

var builder = new DocumentBuilder(new Document());
builder.Writeln("```csharp");
builder.Writeln("Console.WriteLine(\"Hello Markdown\");");
builder.Writeln("```");

Cele mai bune practici

  • Utilizați API-urile DOM în loc de regex pentru transformări.
  • Centralizarea metadata in front-matter pentru compatibilitatea generatorului.
  • Reutilizarea obiectelor documentului pentru actualizările de batch.
  • Modificări în lanț pentru a minimiza utilizarea memoriei.
  • APIs pre-încălzite în mediile serverului pentru a reduce latența primei apeluri.
  • Urmăriți utilizarea licențelor în tuburile CI/CD.

cazuri comune de utilizare

  • Automatizare Generația Readme.
  • Creați articole de bază a cunoștințelor în mod dinamic.
  • Convertarea datelor structurate în docuri Markdown.
  • Păstrarea unei documentări mari este programată.
  • Pregătiți Markdown pentru generatoare de locație statică.

FAQ

**Ce caracteristici Markdown sunt susținute?**Titluri, liste, tabele, imagini, legături, formatare inline, blocuri de cod și front-matter.

**Pot converti Markdown în alte formate?**Da, încărcătura .md și salvează în DOCX, PDF sau HTML folosind Aspose.Words.

**Sunt păstrate front-matterele?**Şi da. YAML și secțiunile front-matter ale TOML sunt citite / scrise.

**Suportă link-ul în stil de referință?**Da, sunt susținute atât link-uri inline, cât și referință-stile.

**Este sigură?**Da, atâta timp cât fiecare fir utilizează propria sa instanta Document.

 Română