Składnia Markdown

Na portalu w tekstach można używać składni Markdown. Jej uproszczony opis znajduje się poniżej.

Nagłówki

Nagłówek utworzyć można poprzez rozpoczęcie wiersza znakiem „#”. Od liczby haszów zależy poziom nagłówka — jeden hasz oznacza nagłówek pierwszego poziomu, dwa — drugiego, trzy — trzeciego, etc.

Z powodów estetycznych, można nagłówek również zamknąć haszem, przy czym ich liczba nie musi się zgadzać.

Przykład:

# Nagłówek 1. poziomu
## Nagłówek 2. poziomu
### Nagłówek 3. poziomu ###
#### Nagłówek 4. poziomu ##

Akapity

Akapity tworzone są z tekstu zaczynającego się od nowego wiersza. Aby rozdzielić dwa akapity lub oddzielić akapit od innego elementu tekstu, należy zostawić pustą linię.

Przykład:

Pierwszy akapit.

Drugi akapit.
Nadal drugi akapit.

Trzeci akapit.

Wyróżnienie tekstu

Kursywa

Aby użyć kursywy, należy tekst otoczyć pojedyńczymi gwiazdkami (*) lub podkreślnikami (_).

Przykład:

Lorem *ipsum* dolor sit _amet_.

Pogrubienie

Aby pogrubić tekst, należy otoczyć go podwójnymi gwiazdkami (**) lub podkreślnikami (__).

Przykład:

Lorem **ipsum** dolor sit __amet__.

Tekst maszynowy

Aby użyć czcionki maszynowej, należy otoczyć tekst gravisami (`!``).

Przykład:

Lorem ipsum `dolor` sit amet.

Listy

Lista uporządkowana

Aby utworzyć listę uporządkowaną, należy rozpocząć wiersz od cyfry zakończonej kropką. Nie muszą to być kolejne cyfry.

Przykłady:

1. Jeden
2. Dwa
3. Trzy


1. Jeden
1. Dwa
1. Trzy


1. Jeden
6. Dwa
2. Trzy

Lista nieuporządkowana

Aby utworzyć listę nieuporządkowaną, należy rozpocząć wiersz od gwiazdki (*), plusa (+) lub minusa (-).

Przykłady:

Przykład 1:

* Jeden
* Dwa
* Trzy

Przykład 2:

+ Jeden
+ Dwa
+ Trzy

Przykłada 3:

- Jeden
- Dwa
- Trzy

Podpunkty

Aby utworzyć podpunkt, wystarczy zrobić wcięcie.

Przykład:

* Jeden
* Dwa
  * Dwa A
  * Dwa B
* Trzy

Bloki kodu

Bloki kodu tworzy się poprzez wcięcie tekstu czterema spacjami lub tabulatorem.

Przykład:

    #!/bin/sh
    echo "Hello World!"

Cytaty

Cytaty tworzy się analogicznie jak w poczcie elektronicznej, przez rozpoczęcie wiersza znakiem „>”. W cytacie mogą znajdować się inne elementy, takie jak akapity, nagłówki, listy czy bloki kodu, a także zagnieżdżone cytaty.

Przykład:

> Pierwszy akapit cytatu.
>
> Drugi akapit cytatu.
>
> > Cytat zagnieżdżony
>
>     fragment kodu

Linki

Na link składa się treść linka umieszczona w nawiasie kwadratowym ([]) oraz adres umieszczony w zwykłym nawiasie. Opcjonalnie po adresie można podać tytuł w cudzysłowiu.

Przykład:

Lorem ipsum [dolor](http://www.example.org/ "Przykładowy link") sit amet.

Lorem ipsum [dolor](http://www.example.org/) sit amet.

Na DUG-u dostępny jest [serwer Jabbera](/jabber/ "DUG-owy Jabber").

Grafiki

Grafiki tworzy się podobnie jak linki. W nawiasie kwadratowym ([]) podaje się tekst alternatywny, następnie w zwykłym nawiasie adres pliku oraz opcjonalny tytuł. Aby odróżnić grafikę od linka, przed nawiasem kwadwatorym wstawia się wykrzyknik.

Przykład:

![przykładowy obraz](http://new.dug.net.pl/template/gfx/dug.png "Logo")

Linia pozioma

Linię poziomą można utworzyć w następujące sposoby:

* * *

***

*****

- - -

---------------------------------------

Zaprzeczenia i zabezpieczenia

Aby uniknąć przypadkowego zinterpretowania pewnych znaków, można je poprzedzić odwrotnym ukośnikiem.

Przykłady:

\*Zwykły tekst\*

\![link poprzedzony wykrzyknikiem](http://www.example.org)

3\. zdanie w przykładzie, które wcale nie jest elementem listy uporządkowanej.

Oryginalny opis

Oryginalny opis składni (po angielsku) znajduje się na stronie domowej.