Aspose.Words Markdown failų procesorius .NET

Aspose.Words Markdown File Processor .NET leidžia kūrėjams programinėmis priemonėmis sukurti, įkrauti, redaguoti ir išsaugoti „Markdown“ dokumentus naudojant tą patį pažįstamą objektų modelį kaip „Aspoe.Vords.

Įdiegimas ir nustatymas

  • Įdiegti NuGet paketą Aspose.Words.
  • Pateikite savo licenciją ( Išmatuota licencija ).
  • Pridėti į Aspose.Words Pavadinimas Jūsų projektui.
  • Dėl pagrindinių tikslų ir paketo nustatymų žr Įdiegimo vadovas .

Palaikomos platformos: Windows, Linux, macOS, mobiliosios operacinės sistemos su .NET Framework, .Net Core/5/6+, arba Mono.IDEs: Visual Studio 2010–2022, Xamarin, MonoDevelop.

Greitas pradžia: sukurkite „Markdown“ failą 

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

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

doc.Save("Output.md");

Savybės ir funkcionalumas

Dokumentų kūrimas

  • Sukurkite naują .md Filmas yra dinamiškas.
  • Įveskite antraštes, skyrius, sąrašus, lenteles ir metaduomenis.
  • Įveskite dokumentų lygio savybes, tokias kaip pavadinimas, autorius ir žymės.

Dokumentų įkrovimas

  • Įkrovos egzistuoja .md failus iš diskų, srautų ar juostų.
  • Išsaugo struktūrą: antraštes, lenteles, sąrašus ir inline formatavimą.
  • Palaiko kodo bloko langus, metaduomenis ir nuorodas referencinio stiliaus.

DOM (dokumentinio objekto modelis)

  • Prieiga ir manipuliavimas:

  • Praktai ir bėgimai (baldas, italų, griežtas, inline kodas)

  • Sklypas (H1 – H6)

  • sąrašai (paskirtas / nerekomenduojamas, nešvarus)

  • lentelės, žiedai ir ląstelės

  • CodeBlock“ ir „InlineCod“ sąsajos

  • Links & Images (su alt tekstais, pavadinimais ir URL)

Tekstas ir inline formatavimas

  • Taikykite „Markdown“ sintezę per „Run“ atributus.
  • Džiaugiamės drąsais (**), Italų kalba (*), ir griežtai (~~), Įrašas ir kodas (```).
  • Veikia formatuojant per pastraipus ir sąrašus patikimai.

Pagrindai ir skyriai

  • Programuota pakoreguoti vadovavimo lygius.
  • Reorganizuokite TOC generavimo skyrius.
  • Skirstomi arba sujungti blokai, pagrįsti pavadinimu.

Sąrašai ir Nested sąrašas

  • Įsakymas įteiktas (1., 2.) arba išmatuoti (-, *) ir sąrašus.
  • Konvertuoti straipsnius į sąrašo elementus.
  • Įveskite, pašalinkite arba dinamiškai pakeiskite sąrašo tipus.

Tables

  • Sukurkite ir manipuliuokite „GitHub“ žymėjimo lentelėmis.
  • Įveskite eilutes / kolonus, sujungti ląsteles ir redaguoti turinį.
  • Multilino ląstelių palaikymas su išsaugotu formatu.

Nuotraukos ir nuorodos

  • Įtraukti arba atnaujinti nuotraukų nuorodas (![alt](url "title")).
  • Įveskite nuorodą ([text](url "title")).
  • Palaiko inline ir referencinio stiliaus nuorodų sintezę.

Kodų blokai

  • Įveskite kodo blokus su kalbos žymėmis (‘csharp).
  • Valdykite inline kodo spanas su savarankišku pabėgimu.
  • Tinkamai pritaikykite stilius (backticks arba tildes).

Metadatos ir Front-Matter

  • Skaityti / rašyti YAML arba TOML priekinis matas.
  • Laikykite statinių vietų generatorių metaduomenis (Hugo, Jekyll ir kt.).

Taupymas ir eksportas

  • Išsaugokite atgal .md Su galimybe:

  • Išsaugokite baltąją erdvę ir komentarus.

  • Normalizuokite indentaciją ir linijos galus.

  • Strip arba atnaujinti metaduomenis su callbacks.

Išplėstiniai pavyzdžiai

Įdiegti esamą 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");

Įveskite kodo bloką 

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

Geriausios praktikos

  • Naudokite DOM API vietoj regex transformacijoms.
  • Centralizuokite metaduomenis priekinėje dalyje generatorių suderinamumui.
  • Pakartotinai naudoti dokumentų objektus batch atnaujinimui.
  • Chain modifikacijos, siekiant sumažinti atminties naudojimą.
  • Pre-karšto API serverio aplinkoje, siekiant sumažinti pirmųjų skambučių latentą.
  • Stebėkite licencijų naudojimą CI / CD vamzdžiuose.

Dažniausiai naudojami atvejai

  • Automatizavimas ** README karta**.
  • Sukurti ** žinių bazės straipsnius** dinamiškai.
  • Konvertuoti struktūrizuotus duomenis į Markdown dokus.
  • Didelės dokumentacijos tvarkymas yra programuojamas.
  • Rekomenduojamas statinių svetainių generatorių paruošimas.

FAQ

**Kokias „Markdown“ funkcijas palaiko?**Žymos, sąrašai, lentelės, nuotraukos, nuorodos, inline formatavimas, kodo blokai ir front-matter.

**Ar galiu konvertuoti „Markdown“ į kitus formatus?**Taip, įkrovimas .md ir išsaugoti DOCX, PDF arba HTML naudojant Aspose.Words.

**Ar išsaugotas frontas?**Taip ir. YAML ir TOML front-matter skirsniai yra perskaityti / parašyti.

**Ar tai palaiko nuorodas referencinio stiliaus?**Taip. palaikomi tiek inline, tiek referencinio stiliaus nuorodos.

**Ar tai yra saugu?**Taip, tol, kol kiekvienas juostas naudoja savo dokumentų instinktą.

 Lietuvių