Pentru cine este

Documentația în Markdown, fără curățenie

Q: Se păstrează notele de subsol dintr-o pagină de documentație?

Da. Linkurile de referință sunt adunate în note `[^1]`, cu definițiile la finalul fișierului, înainte ca filtrul de curățare să șteargă identificatorii de care depind.

Mutarea unei documentații înseamnă de obicei să convertiți HTML și apoi să pierdeți mai mult timp scoțând ce a păstrat convertorul. Scoaterea este exact partea pentru care a fost construită extensia, și partea care a fost măsurată: zero resturi de etichete HTML pe cele 512 pagini preluate. Titlurile, listele, tabelele, gardurile de cod și notele ajung în Markdown standard.

Migrarea care se face de mână

Un set de documentație mutat de pe un site vechi vine cu tot ce ținea de site, nu de conținut. Bara laterală de navigație intră ca o listă lungă la începutul fiecărui fișier, selectorul de versiune se repetă de o sută de ori, iar butoanele „a fost utilă pagina” se strecoară la final. Fiecare fișier trebuie deschis, tăiat la cap și la coadă, și verificat că nu s-a tăiat prea mult.

Apoi vine partea care doare cu adevărat: structura. Titlurile își pierd nivelul și tot documentul devine plat, casetele de atenționare se transformă în paragrafe obișnuite, iar gardurile de cod ies fără limbaj. Rezultatul se importă, dar nu se poate publica așa, și reparatul unui singur fișier ia mai mult decât ar lua rescrierea lui.

Ce trece prin conversie

Titlurile, listele, tabelele, blocurile de cod și notele de subsol ajung toate în Markdown standard
Etichetele de limbaj rămân pe garduri: 73 de blocuri din 156 pe corpusul tehnic, față de 20 și 0
Zero resturi de etichete HTML pe cele 512 pagini măsurate
Barele laterale de navigație și selectoarele de versiune sunt tăiate, nu convertite
Casetele de atenționare devin citate-bloc, ca să nu se piardă conținutul lor
Tiparul de nume de fișier și subdosarul țin un set importat în ordine de la prima pagină

Titluri, bloc de cod și casetă de atenționare, toate în Markdown standardlearn.microsoft.com/ro-ro/powershell

---
title: "Lucrul cu fișiere și dosare"
source: "https://learn.microsoft.com/ro-ro/powershell/scripting/samples/"
extraction: "dom"
---

## Listarea fișierelor dintr-un dosar

```powershell
Get-ChildItem -Path ./documente -Recurse -Filter *.md
```

> Notă: parametrul `-Recurse` parcurge și subdosarele.

Ce nu face

Nu parcurge un site de documentație și nu preia mai multe file deodată: o pagină pe rând, cea pe care vă aflați. Nu reface legăturile interne dintre pagini, așa că un link către altă secțiune rămâne un link către site-ul original, nu către fișierul vecin. Nu descarcă imaginile și nu le pune lângă fișier; ele rămân linkuri. Și nu inventează o etichetă de limbaj pe care pagina nu o dă: gardul rămâne gol, ca să nu ajungă în documentație o etichetă greșită.

Adaugă în Chrome – gratuitGratuit în întregime, fără cont și fără limite.

Întrebări

Cât de fidelă este structura titlurilor?

Nivelurile de titlu sunt păstrate așa cum apar în corpul articolului. Titlurile goale – un rest frecvent al blocurilor de navigație – sunt eliminate.

Dar casetele de atenționare?

Devin citate-bloc. Markdownul nu are o sintaxă standard pentru casete, așa că se păstrează conținutul, nu stilul.

Poate muta un site întreg de documentație?

Nu dintr-o dată. Preluarea este o pagină pe rând, fără crawler și fără procesare în lot, așa că mutați exact paginile pe care le vreți.

Ce se întâmplă cu linkurile dintre pagini?

Rămân linkuri către site-ul original. Rescrierea lor către noile căi este un pas pe care îl faceți în editor, după import.

Se păstrează notele de subsol dintr-o pagină de documentație?

Da. Linkurile de referință sunt adunate în note [^1], cu definițiile la finalul fișierului, înainte ca filtrul de curățare să șteargă identificatorii de care depind.