Formator de liste imbricate și indentare Markdown

Fundația tehnică a randării listelor

Markdown este standardul pentru documentație software, specificații, baze de cunoștințe și comunicare între dezvoltatori. Listele pe un nivel (- item) și cele numerotate (1. item) par simple, dar schițele adânc imbricate aduc complexitate. Parserele — CommonMark, GitHub Flavored Markdown (GFM), Python-Markdown și Pandoc — impun reguli stricte pentru marcaj, raportul tab-spațiu și indentarea sub-blocurilor.

Când lipești între editoare (VS Code, Sublime Text, Xcode, Apple Notes sau Microsoft Word), apar erori tăcute de indentare. Un spațiu lipsă face compilatorul să citească un copil imbricat ca element de top sau ca paragraf izolat. Formatorul de liste imbricate și indentare de la Utiliome parsează structura ca AST (Abstract Syntax Tree) și regenerează Markdown conform specificației.

Reguli de indentare: 2 spații față de 4 spații

1. Regula de 2 spații (GFM standard și Prettier): Pe GitHub, Docusaurus, Nextra și Obsidian, 2 spații pe nivel sunt standardul. Conținutul copil se aliniază sub începutul textului părinte:

   - Top-level item 1
     - Nested child item 1.1
     - Nested child item 1.2
       - Deeply nested grandchild item 1.2.1
   - Top-level item 2
   

2. Regula de 4 spații (CommonMark strict și Python-Markdown): Implementările stricte cer ca blocurile copil, snippet-urile de cod și listele imbricate din liste ordonate să fie indentate cu 4 spații (sau un tab) ca să rămână în blocul părinte:

   1. First ordered step in workflow
       - Associated sub-bullet A
       - Associated sub-bullet B
   2. Second ordered step in workflow
   

3. Capcana tab față de spațiu: Amestecul de tab-uri fizice (\t) cu spații ASCII (\x20) este cauza principală a randării stricate. Motoarele web traduc tab-urile inconsistent (adesea 4 sau 8 coloane). Utiliome convertește toate tab-urile în spații uniforme, după configurația ta.

Normalizarea marcajelor și repararea secvențelor ordonate

Markdown suportă trei caractere pentru liste neordonate: cratimă (-), asterisc (*) și plus (+). Toate produc elemente HTML (<ul>), dar amestecul în același document creează zgomot vizual și pică lintere (regula markdownlint MD004).

Numerotarea se strică la editare iterativă. Autorii lipesc elemente la mijloc sau se bazează pe auto-increment 1.:

<!-- Unformatted / Broken Input -->
* Feature A
- Feature B
+ Feature C

1. Initial step
1. Second step (copied from draft)
4. Out-of-order step

Formatorul normalizează marcajele neordonate la caracterul ales (de exemplu totul devine -) și renumerotează secvențele (1., 2., 3.) sau le standardizează la incremente de o cifră (1., 1., 1.), după ghidul echipei.

Riscurile de securitate și productivitate ale uneltelor vechi

Inginerii, technical writerii, cercetătorii și analiștii curăță bullet-uri, reformatează transcrieri sau restructurează roadmap-uri online. Uneltele tradiționale aduc fricțiune și expunere:

• Transmitere pe server remote: Uneltele tipice trimit textul prin HTTP POST. Note de arhitectură, roadmap-uri nelansate, credențiale API sau schițe juridice pe servere terțe creează risc de conformitate.
• Ziduri de cont și tracking de e-mail: Site-urile vechi cer OAuth sau e-mail doar ca să copiezi textul curat, apoi folosesc datele pentru marketing.
• Limite zilnice și paywall: SaaS-ul plătit limitează operațiile (de exemplu maxim 5 curățări în 24 de ore) sau trunchiază outputul până cumperi abonament.
• Latență și dependență de conexiune: Fiecare acțiune cere dus-întors. Latența, timeout-urile sau mediul offline rup fluxul.

Arhitectura local-first de la Utiliome

Formatorul de liste imbricate și indentare urmează principii local-first:

1. Sandbox de execuție 100% în browser

Parserul și motorul se încarcă în runtime-ul JavaScript. Tokenizarea, calculul indentării, traversarea AST, substituția marcajelor și sortarea rulează pe CPU-ul local. Niciun octet de text nu părăsește dispozitivul.

2. Zero fricțiune de înregistrare

Nu există formulare, captură de e-mail, captcha sau cont. Deschizi pagina, lipești schița, configurezi și copiezi în secunde.

3. Conformitate de confidențialitate enterprise

Textul rămâne în memoria browserului, deci unealta se aliniază politicilor corporate, regulilor SOC 2, GDPR și HIPAA. Poți formata specificații interne și loguri confidențiale.

4. Viteză sub o milisecundă

Procesarea pe client elimină latența. O listă de 5 rânduri sau o schiță de 10.000 de rânduri se recalculează instant, pe măsură ce scrii.

Documentație tehnică și project management

Documentația eficientă se sprijină pe schițe ierarhice. La onboarding, specificații de endpoint API sau note de lansare, motorul de liste al Utiliome simplifică fluxul:

1. Restructurarea schițelor imbricate

Schițele complexe se prăbușesc în pereți de text la brainstorming. Poți schimba nivelurile de indentare pe selecții mari. La 2 sau 4 spații exacte, subiectele copil se aliniază sub categorii:

# Project Roadmap Output Example
- Phase 1: Architecture Planning
  - Database Schema Design
    - Define PostgreSQL table indexes
    - Configure Prisma ORM models
  - Security & Authentication
    - Implement JWT cookie validation
- Phase 2: Core Feature Implementation
  - Markdown Editor Widget
    - Integrated live AST syntax highlighter

2. Sortare și deduplicare

Când agregi liste de la mai mulți membri sau din loguri — variabile de mediu, dependențe, cereri de funcții — sortarea și eliminarea duplicatelor manual sunt plictisitoare. Transformările incluse:

• Sortare alfabetică (A–Z / Z–A): Ordonează elementele de top și păstrează sub-arborii.
• Sortare după lungimea rândului: Utilă pentru badge-uri UI sau liste de tag-uri.
• Filtru de deduplicare: Identifică și elimină elementele identice.

3. Conversie de tip dintr-un clic

• Bullet neordonat în listă numerotată: Idei informale devin tutoriale secvențiale.
• Bullet în checklist GFM interactiv: Cerințe statice devin checkbox-uri de task list GitHub (- [ ]).
• Listă în paragraf / CSV: Aplatizează bullet-urile în valori separate prin virgulă sau în proză continuă.

Repararea indentării, normalizarea sintaxei, sortarea și conversia de tip stau într-o singură unealtă privacy-first.