showmd

showmd: Rewolucja w podglądzie plików Markdown na systemie macOS

Pliki Markdown stały się standardem w dokumentacji technicznej, notatkach programistycznych i komunikacji z AI. Jednak domyślny podgląd w systemie macOS często zawodzi, wyświetlając surowy kod pełen znaczników zamiast sformatowanej treści. showmd to rozwiązanie tego problemu – darmowy, otwartoźródłowy czytnik, który sprawia, że pliki .md stają się w pełni czytelne bezpośrednio w Finderze.

What's showmd?

showmd to wyspecjalizowane narzędzie typu Quick Look extension dla systemu macOS, stworzone z myślą o użytkownikach, którzy potrzebują błyskawicznego i estetycznego podglądu plików Markdown. Aplikacja nie jest edytorem ani rozbudowanym kombajnem do notatek – jej jedynym i najważniejszym zadaniem jest poprawne renderowanie treści Markdown tak, aby wyglądały one dokładnie tak, jak po opublikowaniu na GitHubie czy w profesjonalnej dokumentacji.

Program rozwiązuje problem nieczytelnych plików AI (takich jak AGENTS.md czy CLAUDE.md), które często zawierają tagi XML, skomplikowane schematy i metadane YAML. Dzięki showmd, zamiast widzieć „ścianę tekstu” z hashami i gwiazdkami, użytkownik otrzymuje przejrzysty, sformatowany dokument.

Features – Dlaczego warto wybrać showmd?

Narzędzie showmd wyróżnia się na tle konkurencji szeregiem zaawansowanych funkcji, które czynią go najbardziej kompletnym darmowym viewerem na macOS:

• Pełne wsparcie GitHub Flavored Markdown (GFM): Obsługa tabel, list zadań, przekreśleń, autolinków i przypisów dzięki silnikowi swift-markdown od Apple.
• Renderowanie Frontmatter YAML: Dane metadanych są prezentowane jako elegancka, zwijalna tabela. Jest to unikalna funkcja showmd, której brakuje w większości innych przeglądarek.
• Wsparcie dla Agentic AI Tags: Specjalne tagi XML używane przez AI (np. <instructions>, <example>, <thinking>) są renderowane jako obramowane bloki z etykietami.
• Diagramy Mermaid i wzory LaTeX: Renderowanie schematów blokowych, diagramów sekwencji oraz równań matematycznych (przez KaTeX) bezpośrednio w oknie podglądu.
• Podświetlanie składni (Syntax Highlighting): Obsługa ponad 190 języków programowania wewnątrz bloków kodu.
• Natywne doświadczenie macOS: Aplikacja wspiera tryb ciemny (dark mode), systemowe fonty i jest zoptymalizowana pod kątem szybkości – otwiera się w ułamku sekundy.
• Prywatność i bezpieczeństwo: Wszystkie operacje odbywają się lokalnie. showmd nie wysyła danych do chmury, nie posiada telemetrii i nie wymaga połączenia z internetem.
• Obsługa wielu rozszerzeń: Program rozpoznaje nie tylko .md, ale również .mdx, .markdown, .mdc, .rmd, .qmd, .mdown i wiele innych.

How to Use – Instalacja i konfiguracja

Rozpoczęcie pracy z showmd jest niezwykle proste i zajmuje mniej niż minutę. Możesz wybrać jedną z dwóch metod instalacji:

Metoda 1: Bezpośrednie pobranie

1. Pobierz plik showmd.dmg (podpisany i notyfikowany przez Apple).
2. Przeciągnij aplikację do folderu Applications.
3. Otwórz aplikację raz, aby zarejestrować rozszerzenie w systemie.

Metoda 2: Homebrew

Jeśli korzystasz z terminala, wpisz poniższą komendę: brew install --cask johannesnagl/tap/showmd

Aktywacja w systemie

Po zainstalowaniu wykonaj poniższe kroki, aby włączyć funkcję Quick Look:

1. Przejdź do Ustawienia systemowe > Prywatność i bezpieczeństwo > Rozszerzenia.
2. Wybierz sekcję Quick Look.
3. Zaznacz pole przy showmd.
4. Przy pierwszym uruchomieniu system może zapytać o dostęp do danych innych aplikacji – kliknij „Pozwól”, aby umożliwić współdzielenie ustawień.

Teraz wystarczy zaznaczyć dowolny plik .md w Finderze i nacisnąć Spację, aby cieszyć się pięknym podglądem.

Use Case – Kiedy showmd jest niezastąpiony?

showmd znajduje zastosowanie w codziennej pracy wielu specjalistów:

• Programiści: Szybki podgląd plików README.md lub dokumentacji technicznej w repozytoriach bez otwierania VS Code czy przeglądarki.
• Inżynierowie AI: Analiza instrukcji dla agentów AI i logów zawierających tagi XML i metadane YAML.
• Analitycy danych: Przeglądanie notatek w formacie .rmd lub .qmd zawierających wzory matematyczne LaTeX.
• Technical Writers: Weryfikacja poprawności renderowania tabel, alertów GitHub (TIP, WARNING, NOTE) oraz obrazów lokalnych przed publikacją.

FAQ – Najczęściej zadawane pytania

Czy showmd jest płatny? Nie, showmd jest całkowicie darmowy i dostępny jako open-source na licencji MIT. Jeśli narzędzie Ci się podoba, możesz dobrowolnie „postawić autorowi pastę”.

Czy mogę edytować pliki w showmd? Nie. showmd to wyłącznie przeglądarka (viewer). Jej celem jest szybkie i lekkie wyświetlanie treści bez obciążania systemu funkcjami edycyjnymi.

Czy showmd obsługuje tryb ciemny? Tak, aplikacja automatycznie dopasowuje się do ustawień systemowych macOS. Możesz również ręcznie wymusić tryb jasny lub ciemny w ustawieniach aplikacji.

Czy mogę zobaczyć surowy kod Markdown? Tak. W górnej części okna podglądu znajduje się przełącznik „Rendered / Source”, który pozwala na błyskawiczne przejście do widoku surowego tekstu. Możesz również skopiować treść jako gotowy kod HTML.

Czym showmd różni się od innych narzędzi? W przeciwieństwie do płatnych alternatyw, showmd oferuje w standardzie zaawansowane funkcje, takie jak renderowanie diagramów Mermaid, obsługa metadanych YAML oraz specjalne formatowanie dla tagów AI, pozostając przy tym narzędziem lekkim i darmowym.