4529
edycji
Markdown: Różnice pomiędzy wersjami
m
Int.
m (→Zobacz też: Poprawa linków.) |
m (Int.) |
||
| Linia 1: | Linia 1: | ||
'''Markdown''' – język znaczników służący do formatowania tekstu. Został zaprojektowany tak, by umożliwić konwersję z czystego tekstu sformatowanego przy jego użyciu na inne wyjściowe formaty (głównie HTML). Pliki Markdown posiadają najczęściej rozszerzenie {{Kod|.markdown}}, {{Kod|.md}}, ale mogą występować także w zwykłym {{Kod|.txt}}. | '''Markdown''' – język znaczników służący do formatowania tekstu. Został zaprojektowany tak, by umożliwić konwersję z czystego tekstu sformatowanego przy jego użyciu na inne wyjściowe formaty (głównie HTML). Pliki Markdown posiadają najczęściej rozszerzenie {{Kod|.markdown}}, {{Kod|.md}}, ale mogą występować także w zwykłym {{Kod|.txt}}. | ||
Markdown jest często używany w celu formatowania plików readme | Markdown jest często używany w celu formatowania plików readme bądź przy formatowaniu tekstu na forach internetowych. Jest także m.in. używany podczas formatowania tekstu w [[Discord]]zie. | ||
Do konwersji z Markdowna najlepiej korzystać z gangsterskiego programu [[pandoc]]. | Do konwersji z Markdowna najlepiej korzystać z gangsterskiego programu [[pandoc]]. | ||
| Linia 10: | Linia 10: | ||
== Zalety korzystania z Markdowna == | == Zalety korzystania z Markdowna == | ||
Markdown w porównaniu do innych formatów zdecydowanie ma wiele zalet: | Markdown w porównaniu do innych formatów zdecydowanie ma wiele zalet: | ||
* '''Dostępność''' – aby korzystać czy pisać w Markdownie nie trzeba specjalnych programów, wystarczy zwykły edytor tekstowy, na przykład windowsowy Notatnik. Można też korzystać z bardziej zaawansowanych edytorów, jak [[Notepad++]] czy Atom, które zadbają o podkreślanie składni i mogą automatycznie poformatować listy czy tabele. | * '''Dostępność''' – aby korzystać czy pisać w Markdownie, nie trzeba specjalnych programów, wystarczy zwykły edytor tekstowy, na przykład windowsowy Notatnik. Można też korzystać z bardziej zaawansowanych edytorów, jak [[Notepad++]] czy Atom, które zadbają o podkreślanie składni i mogą automatycznie poformatować listy czy tabele. | ||
* '''Ponadczasowość''' – w przeciwieństwie do formatów tekstowych jak {{Kod|.doc}} czy {{Kod|.docx}} Markdown jest zwykłym plikiem tekstowym i jego wygląd i struktura będzie identyczna, niezależna od wersji oprogramowania. Przykładowo przestarzałe formaty {{Kod|.doc}} często mają problem z zachowaniem oryginalnego wyglądu dokumentu po przekonwertowaniu na nowsze {{Kod|.docx}}, a i nowszy format czasem sprawia problemy w zależności od pakietu biurowego, w jakim go otworzymy. | * '''Ponadczasowość''' – w przeciwieństwie do formatów tekstowych jak {{Kod|.doc}} czy {{Kod|.docx}} Markdown jest zwykłym plikiem tekstowym i jego wygląd i struktura będzie identyczna, niezależna od wersji oprogramowania. Przykładowo przestarzałe formaty {{Kod|.doc}} często mają problem z zachowaniem oryginalnego wyglądu dokumentu po przekonwertowaniu na nowsze {{Kod|.docx}}, a i nowszy format czasem sprawia problemy w zależności od pakietu biurowego, w jakim go otworzymy. | ||
* '''Czytelność''' – Markdown w przeciwieństwie do HTML pozostaje czytelny nawet w formacie źródłowym, w postaci nieprzetworzonego tekstu. | * '''Czytelność''' – Markdown w przeciwieństwie do HTML pozostaje czytelny nawet w formacie źródłowym, w postaci nieprzetworzonego tekstu. | ||
| Linia 20: | Linia 20: | ||
Dla osób niezaznajomionych z tym systemem formatowania tekstu Markdown może rodzić następujące problemy: | Dla osób niezaznajomionych z tym systemem formatowania tekstu Markdown może rodzić następujące problemy: | ||
* '''Zarezerwowane znaki''' – wiele znaków w Markdownie pełni określoną funkcję, na przykład określa początek listy numerowanej, pogrubienie, pochylenie, link, itd. Stąd też znaki <code>*</code>, <code>_</code>, <code>#</code>, <code>{ }</code>, <code>[ ]</code>, <code>( )</code> mogą być przeróżnie parsowane w zależności od kontekstu. | * '''Zarezerwowane znaki''' – wiele znaków w Markdownie pełni określoną funkcję, na przykład określa początek listy numerowanej, pogrubienie, pochylenie, link, itd. Stąd też znaki <code>*</code>, <code>_</code>, <code>#</code>, <code>{ }</code>, <code>[ ]</code>, <code>( )</code> mogą być przeróżnie parsowane w zależności od kontekstu. | ||
** Zazwyczaj pomaga użycie backslasha przed znakiem, który chcemy by został zachowany. Chcąc np. napisać {{Kod|*niemożliwe*}} bez emfazy (pochylenia) zapiszemy <code>\*niemożliwe\*</code>. | ** Zazwyczaj pomaga użycie backslasha przed znakiem, który chcemy by został zachowany. Chcąc np. napisać {{Kod|*niemożliwe*}} bez emfazy (pochylenia), zapiszemy <code>\*niemożliwe\*</code>. | ||
* '''Brak jednego standardu''' – oryginalna wersja Markdowna została co prawda ustandaryzowana, nie mniej jednak występuje wiele nieoficjalnych rozszerzeń dla tego formatu, stosowanych na przeróżnych stronach, których implementacja zależy od danego oprogramowania. Przykładowo: Markdown używany na GitHubie (GFM, ''GitHub Flavored Markdown'') pozwala na tworzenie tabel, przekreśleń, automatycznych linków czy listy zadań z checkboxami. Markdown Extra zaś pozwala na tworzenie listy definicji, skrótów (''abbreviations'') czy przypisów. | * '''Brak jednego standardu''' – oryginalna wersja Markdowna została co prawda ustandaryzowana, nie mniej jednak występuje wiele nieoficjalnych rozszerzeń dla tego formatu, stosowanych na przeróżnych stronach, których implementacja zależy od danego oprogramowania. Przykładowo: Markdown używany na GitHubie (GFM, ''GitHub Flavored Markdown'') pozwala na tworzenie tabel, przekreśleń, automatycznych linków czy listy zadań z checkboxami. Markdown Extra zaś pozwala na tworzenie listy definicji, skrótów (''abbreviations'') czy przypisów. | ||
** Wersja Markdown domyślnie wspierana przez pandoc (''Pandoc’s Markdown'') wspiera m.in. tabele GFM, listy definicji, przypisy, tworzenie bibliografii (np. BibTeX), wzory matematyczne (LaTeX, MathJax). | ** Wersja Markdown domyślnie wspierana przez pandoc (''Pandoc’s Markdown'') wspiera m.in. tabele GFM, listy definicji, przypisy, tworzenie bibliografii (np. BibTeX), wzory matematyczne (LaTeX, MathJax). | ||