Zeilen als nummerierte Markdown-Liste formatieren

Fügen Sie Schritte, Anforderungen, Tagesordnungspunkte oder beliebigen anderen zeilenbasierten Text ein, wählen Sie bei einer fortlaufenden Folge die erste Nummer und erhalten Sie sofort ein Format für geordnete Listen, das Sie in Ihre Dokumentation übernehmen können. Die Umwandlung ist deterministisch, bewahrt den ursprünglichen Wortlaut jeder Zeile und vereinheitlicht eingefügte Zeilenenden. Dadurch entsteht unter verschiedenen Betriebssystemen und in unterschiedlichen Automatisierungsumgebungen stets dasselbe Markdown-Ergebnis.

Bereiten Sie pro Zeile einen gewünschten Eintrag vor

Beginnen Sie mit Klartext, in dem jede Zeile einen Eintrag der fertigen geordneten Liste darstellt. Dieses Verfahren eignet sich für aus Notizen kopierte Installationsschritte, aus einem Planungssystem exportierte Abnahmekriterien, Tagesordnungspunkte, Rezeptanweisungen oder kurze Hinweise, die zunächst ohne Formatierung geschrieben wurden. Der Konverter formuliert den Inhalt weder um noch fasst er ihn zusammen, sortiert ihn neu oder deutet ihn. Er behandelt jeden Zeilenumbruch als Grenze eines Eintrags und bewahrt sämtliche Zeichen innerhalb der Zeile. Dazu gehören auch führende Leerzeichen, die in einem technischen Beispiel von Bedeutung sein können. Zeilenenden von Windows, klassischem Mac OS und Unix werden vor der Verarbeitung vereinheitlicht, damit eingefügtes Material überall gleich behandelt wird. Ein vollständig leerer oder nur aus Leerraum bestehender Wert wird abgelehnt, weil daraus keine brauchbare Liste entstehen kann. Leere Zeilen innerhalb des Textes bleiben als leere nummerierte Einträge erhalten. So verändert ein automatisierter Ablauf nicht unbemerkt die Nummer oder Position späterer Einträge. Entfernen Sie unerwünschte Leerzeilen daher vor der Umwandlung.

Legen Sie den Beginn der Nummerierung fest

Standardmäßig lautet die erste Markierung `1.`, also der übliche Beginn einer eigenständigen geordneten Markdown-Liste. Wenn der neue Block eine Folge aus einem anderen Abschnitt fortsetzt, können Sie im Feld `start` eine positive ganze Zahl angeben. Bei einem Startwert von 4 erhalten die ersten drei Eingabezeilen beispielsweise die Markierungen `4.`, `5.` und `6.`. Auf jede Zahl folgen ein Punkt und ein Leerzeichen. Dieses Format für geordnete Listen wird von Markdown-Renderern allgemein unterstützt. Die Ausgabe enthält sowohl eine vollständige Zeichenfolge `markdown` zum Kopieren als auch ein Array `numbered_lines` für Programme, die einzelne Einträge prüfen oder getrennt weiterleiten müssen. Zusätzlich werden `line_count` und der tatsächlich verwendete Wert `start` ausgegeben, sodass sich automatisierte Prüfungen leicht umsetzen lassen. Der Startwert muss eine ganze Zahl im dokumentierten Bereich sein. Dezimalzahlen, numerische Zeichenfolgen, null und negative Werte werden abgelehnt, statt gerundet oder erraten zu werden. Dieser strenge Vertrag sorgt in Browser, API-Clients, Skripten und Testumgebungen für identische Ergebnisse.

Verwenden Sie das Ergebnis in Dokumentation und Automatisierung

Übernehmen Sie den zurückgegebenen Wert `markdown` direkt in eine README-Datei, eine Ticketbeschreibung, einen Wissensdatenbankartikel, die Quelldatei einer statischen Website oder einen anderen Markdown-fähigen Editor. Da das Werkzeug ausschließlich Markierungen für eine geordnete Liste ergänzt, sollten Sie das Ergebnis prüfen, wenn eine ursprüngliche Zeile bereits mit einem Aufzählungszeichen oder einer Zahl beginnt. Diese Zeichen gehören zum Inhalt und bleiben absichtlich erhalten. In einem automatisierten Ablauf senden Sie den Quelltext zusammen mit der optionalen Startnummer und speichern oder veröffentlichen anschließend die zurückgegebene Zeichenfolge, ohne eine Markdown-Bibliothek einzubinden. Der Vorgang nutzt weder Netzwerkzugriffe noch ein generatives Modell, ein Datum oder einen Zufallswert. Gleiche Eingaben liefern daher immer dieselbe Ausgabe. Die Ausführung im Browser eignet sich für gelegentliche Formatierungen; die API kostet $0.002 pro Anfrage und passt zu Dokumentationsgeneratoren sowie Redaktionsabläufen. Größen- und Zeilenlimits begrenzen die Verarbeitung. Teilen Sie größere Quellen in sinnvolle Abschnitte und setzen Sie den Startwert der folgenden Abschnitte passend, um die Nummernfolge beizubehalten.