DevAdventCalendar · Programowanie

Pliki MD w VS Code

Od jakiegoś czasu sporo programuję, wykorzystując Visual Studio Code. Podczas tworzenia kodu przydaje się również dokumentacja. Ostatnio odkryłam funkcję podglądu plików .md, a także wtyczkę, która umożliwia sprawdzanie składni takich plików.

VS Code – podgląd pliku MD

Na początku wystarczy otworzyć plik o rozszerzeniu .md. Wyświetli się w edytorze. Jednakże po kliknięciu w drugą ikonkę po prawej stronie otworzy się podgląd pliku.

VS Code – wtyczka markdownlint

Jeśli chcemy zachować poprawność składni, warto pobrać sobie takie rozszerzenie jak markdownlint:

Po zamknięciu podglądu pliku .md i jego ponownemu otwarciu widać, że sprawdził składnię i podkreślił uwagi na zielono:

Przykładowo pierwszy problem to brak pustych linii otaczających nagłówek:

A kolejny to zbyt wiele nagłówków najwyższego poziomu w dokumencie:

Wszystkie zmiany, jakie wprowadziłam w istniejącym kodzie, możecie zobaczyć w szczegółach commita.

Wszystkie zasady wtyczki markdownlint możecie przeanalizować na jej GitHubie.

Skomentuj

Wprowadź swoje dane lub kliknij jedną z tych ikon, aby się zalogować:

Logo WordPress.com

Komentujesz korzystając z konta WordPress.com. Wyloguj /  Zmień )

Zdjęcie na Google

Komentujesz korzystając z konta Google. Wyloguj /  Zmień )

Zdjęcie z Twittera

Komentujesz korzystając z konta Twitter. Wyloguj /  Zmień )

Zdjęcie na Facebooku

Komentujesz korzystając z konta Facebook. Wyloguj /  Zmień )

Połączenie z %s