Akapity

Akapit definiujemy jako jedną lub więcej linii tekstu rozdzielonych przynajmniej jedną pustą linią:

To jest przykład prostego akapitu, 
który ilustruje jak działa Markdown.
Ten akapit ma wiele linii.

To jest następny akapit.

A oto wynik:

Znaki końca linii są usunięte z wyniku: to przeglądarka internetowa decyduje o tym kiedy zacząć nową linię w zależności od dostępnego miejsca. Jeśli jednak chcesz świadomie wstawić znak końca linii wtedy wstaw dwie spacje na końcu linii.

Wyróżnienia

Możesz podkreślić lub wyróżnić pewne części akapitu. Są dwa sposoby, aby tego dokonać: poprzez czcionkę pochyloną (italica) oraz wytłuszczenie (bold).

Aby dokonać podkreślenia porzez pochylenie czcionki użyj gwiazdki (*) lub znak podkreślenia (_). Objęcie fragmentu poprzez użycie jednej gwiazdki lub znaku podkreślenia spowoduje wyświetlenie tekstu czcionką pochyloną, podczas gdy użycie dwóch znaków podkreślenia lub gwiazdki spowoduje wytłuszczenie tekstu:

*pochylona czcionka, pojedyncze gwiazdki*

_pochylona czcionka, pojedyncze znaki podkreślenia_

**wytłuszczenie, podwójne gwiazdki**

__wytłuszczenie, podwójne znaki podkreślenia__

To jest fragment *wyróżniony* pojedynczą gwiazdką.

A oto rezultat:

Zauważ, że nie ma absolutnie żadnej różnicy pomiędzy użyciem gwiazdki i znaku podkreślenia: oba dają identyczny rezultat. Używaj dowolny, który bardziej Ci odpowiada.

Linki

Markdown pozwala stworzyć linki w tekście na dwa sposoby. Możesz wpisać link bezpośrednio w treści lub poprzez referencję.

Linki bezpośrednio w tekście pozwalają na przekierowanie na inną stronę www. Obejmij link w [nawias kwadratowy] i bezpośrednio po nim w nawiasach okrągłych podaj ściezkę http. Tak jak tu:

[Mój najlepszy serwis](http://www.pytamy.pl/)

[Mój najlepszy serwis](http://www.pytamy.pl/ "pytamy.pl")

Drugi przykład zawiera dodatkowo tytuł (title w cudzysłowiu), który przez większość przeglądarek zostanie zinterpretowany jako podpowiedź, gdy zatrzymasz przez chwilę na nim kursor. Użycie tytułu jest opcjonalne.

Linki poprzez referencję działają podobnie z tym, że nie ma potrzeby podawania adresu http bezpośrednio w tekście, co może utrudnić śledzenie treści. Zamiast tego, możesz wstawić samą nazwę linku, a adres http wstawić gdziekolwiek, na przykład na końcu. Wygląda to następująco:

To jest krótki akapit mojego [najlepszego serwisu][ns].

 [ns]: http://www.pytamy.pl/ "pytamy.pl"

Linia z adresem http jest usuwana z treści i zamieniana na link o podanej nazwie:

Ten sposób tworzenia linków jest szczególnie użyteczny, gdy chcesz ten sam link powtórzyć kilka razy.

Linki automatyczne

Jeśli chcesz po prostu wstawić link poprzez adres http, to ujmij adres http w nawiasy < >. Markdown stworzy link automatycznie:

<http://www.pytamy.pl/>

<info@pytamy.pl>

Dla bezpieczeństwa adres email jest kodowany, co pozwala skutecznie oszukać większość spamerskich robaków poszukujących adresów email.

Grafika - zdjęcia - obrazki

Podobnie jak linki grafika może być linkowana na dwa sposoby: bezpośredni oraz poprzez referencję.

Nagłówki

Możesz sformatować swoją wypowiedź używając również nagłówków. W Markdown istnieją dwa sposoby na dodawanie nagłówków od poziomu 1 do 6. Używając notacji “SeText” nagłówki poziomu 1 i 2 zaznacza się następująco:

Nagłówek 1
========

Nagłówek 2
--------

Składnia “atx” pozwala użyć symbolu krzyżyka (#):

# Nagłówek 1 #

## Nagłówek 2 ##

###### Nagłówek poziomu 6

Zauważ, że nie jest konieczne zamykanie nagłówka poprzez ponowne użycie #.

Cytaty

Być może spotkałeś się z następującym sposobem cytowania wypowiedzi innych osób, na przykład w mailu:

Cytat na temat internetu:

> Internet (dosł. międzysieć; od ang. inter – między 
> i ang. net – sieć) to sieć komputerowa o światowym  
> zasięgu łącząca sieci lokalne, sieci rozległe  
> i wszystkie komputery do nich podłączone. 

Do cytatu możesz wstawić więcej niż jeden akapit. Dozwolone jest również cytowanie list porządkowych, itp.

Listy porządkowe

Markdown wspomaga tworzenie list porządkowych numerowanych jak i nienumerowanych. Aby stworzyć listę numerowaną wstaw numer porządkowy i kropkę do poszczególnych wierszy:

1.  Atos
2.  Portos
3.  Aramis

Do utworzenia listy nienumerowanej możesz użyć *, + lub -:

*   Słońce
*   Księżyc
*   Ziemia

Możesz zagnieżdżać listy poprzez wcięcie linii czterema spacjami:

*   Składniki
    -   Mleko
    -   Jajka
*   Przepisy
    1.  Babka
    2.  Wafel

Jeśli Twoja lista zawiera cały akapit, to pozostaw jedną wolną linię odstępu pomiędzy elementami listy. Gdy chcesz wstawić następny akapit, to jego treść powinna być ponownie wcięta przez 4 spacje:

1.  Pierwszy akapit.

    Drugi akapit.

2.  Następny element listy.

3.  I jeszcze następny.

Kody

Fragmenty kodu

Niekiedy bardziej korzystne jest, aby pisany tekst nie był dodatkowo formatowany i zachowana była jednakowa szerokość wszystkich liter. Taki fragment, nazywany kodem, uzyskuje się poprzez wcięcie wiersza czterema spacjami:

Jak wyróżnić fragment tekstu:

    Używając znaków * oraz _.

W kodzie możesz wstawiać tagi HTML oraz inne używane przez Markdown. W takim przypadku nie będą one przetworzone, a tekst pojawi się dokładnie tak jak został wpisany:

Używając znaków * oraz _.

Wstawki kodowe

Używając znaku backtrick (`) możesz w środku akapitu wprowadzić wstawkę kodową:

Proszę nie używać `<script>` tagu.

Rezultat będzie następujący:

HTML

Nie musisz wcale znać tagów HTML aby ładnie sformatować swoją wypowiedź. W serwisie pytamy możesz jednak użyć bezpośrednio dwóch, które nie są wspierane przez składnię Markdown. Możesz użyć tagów <sup> oraz <sub>, aby osiągnąć następujący efekt:

Coś o logarytmie: log<sub>a</sub>b=c oznacza, że a<sup>c</sup>=b

Markdown nie przetworzy tych tagów i przeglądarka wyświetli je następująco:

Pamiętaj, że zawsze klawisz Podgląd daje Ci możliwość sprawdzenia jak Twoja wypowiedź będzie w efekcie końcowym wyglądać.