CSHTML Formatter

CSHTML Formatter verarbeitet ein Dokument, das HTML- und Razor-Code enthält, und gibt eine konsistent formatierte Version aus. Es richtet sich an .NET-Entwickler und Teams, die Razor-Views in ASP.NET Core-Projekten pflegen und neue Entwickler in bestehenden Stilvorgaben schulen. Der Formatter analysiert die Struktur von HTML-Elementen zusammen mit Razor-Blöcken, Razor-Direktiven und serverseitigem Code und formatiert diese so, dass Lesbarkeit und Wartbarkeit steigen, ohne Logik zu verändern. Er nutzt einen Razor-verwalteten Parser, der HTML-Knoten, Razor-Blöcke und Expressions versteht, und wendet anschließend Einrückung, Attributumbrüche, Zeilenlängenbegrenzung und Tag-Ausrichtung an. Die Konfigurationsoptionen umfassen Einrückung (2 oder 4 Leerzeichen), optionalen Attribut-Umbruch mit einer Max-Zeilenlänge und eine Standardisierung der Zeilenenden, sodass sich die Ergebnisse nahtlos in bestehende Code-Stile integrieren lassen. Die Ausgabe bewahrt Razor-Syntax und Direktiven unverändert, selbst wenn komplexe Razor-Konstrukte wie @if, @foreach oder @functions auftreten. Zu den Vorteilen gehören konsistente Code-Form, einfachere Code-Reviews, weniger Stil-Konflikte in Pull Requests und eine schnellere Einarbeitung neuer Teammitglieder. Kernfunktionen sind: konfigurierbare Einrückung, optionaler Attribut-Umbruch, Zeilenend-Normalisierung, Razor-Syntax-Schutz und eine einfache Migration bestehender cshtml-Dateien. Typische Anwendungsfälle: Vorbereiten von Views für Pull Requests, Durchsetzung von Team-Standards, Migration von Legacy-CSHTML, sowie Suchen und Ersetzen über mehrere Dateien mit konsistente Formatierung in CI-/Build-Pipelines. Das Tool unterstützt mehrere ASP.NET Core-Versionen und lässt sich in Formatierungs-Workflows integrieren.