Markdown: Różnice pomiędzy wersjami

Z JoggerWiki
Skocz do: nawigacji, wyszukiwania

Deprecated: Optional parameter $attribs declared before required parameter $contents is implicitly treated as a required parameter in /home/users/jogger/ftp/wiki/includes/Xml.php on line 133
m (Listy nieuporządkowane i uporządkowane)
m (Dostępna składnia)
Linia 38: Linia 38:
 
## Nagłówek drugiego rzędu</pre>
 
## Nagłówek drugiego rzędu</pre>
  
Nagłówki pozostałych poziomów tworzy się analogicznie.
+
Dla drugiego sposobu nagłówki pozostałych poziomów (1-6) tworzy się analogicznie.
  
 
==== Listy nieuporządkowane i uporządkowane ====
 
==== Listy nieuporządkowane i uporządkowane ====
  
 
Listy nieuporządkowane (znaczniki: <code>&lt;ul&gt;&lt;li/&gt;&lt;/ul&gt;</code>) można tworzyć za pomocą dowolnego ze znaków: gwiazdka (<code>*</code>), plus (<code>+</code>), pauza (<code>-</code>):
 
Listy nieuporządkowane (znaczniki: <code>&lt;ul&gt;&lt;li/&gt;&lt;/ul&gt;</code>) można tworzyć za pomocą dowolnego ze znaków: gwiazdka (<code>*</code>), plus (<code>+</code>), pauza (<code>-</code>):
 
<pre>* lorem
 
* ipsum
 
* dolor</pre>
 
 
Listy uporządkowane (znaczniki: <code>&lt;ol&gt;&lt;li/&gt;&lt;/ol&gt;</code>) tworzy się analogicznie, jednak w miejscu znaku powinna znaleźć się (dowolna) liczba z kropką:
 
 
<pre>1. lorem
 
2. ipsum
 
3. dolor</pre>
 
 
Listy nieuporządkowane i uporządkowane mogą zawierać dowolne formatowanie Markdown, a zatem mogą być również zagnieżdżane.
 
 
==== Listy nieuporządkowane i uporządkowane ====
 
 
Listy nieuporządkowane (znaczniki: <code>&lt;ul&gt;&lt;li/&gt;&lt;/ul&gt;</code>) można tworzyć za pomocą dowolnego ze znaków znaków: gwiazdka (<code>*</code>), plus (<code>+</code>), pauza (<code>-</code>):
 
  
 
<pre>* lorem
 
<pre>* lorem
Linia 78: Linia 62:
 
<pre>    Przykładowy blok kodu</pre>
 
<pre>    Przykładowy blok kodu</pre>
  
Formatowanie Markdown wewnątrz takiego blogu zostanie zignorowane.
+
Formatowanie Markdown wewnątrz takiego bloku zostanie zignorowane.
  
 
==== Linie poziome ====
 
==== Linie poziome ====

Wersja z 13:55, 24 wrz 2009

Informacje ogólne

Markdown jest prostym językiem znacznikowym przeznaczonym do formatowania zwykłego tekstu, konwertowanego następnie do poprawnego składniowo kodu HTML. Markdown udostępniany jest na licencji pochodnej od BSD.

Markdown na Joggerze

Można wykorzystać Markdown do formatowania treści wpisów lub treści komentarzy na własnym joggerze.

Markdown wykorzystywany dla komentarzy nie udostępnia możliwości formatowania nagłówków, poziomych linii ani obrazków. Ponadto, automatyczna korekta znaków typograficznych została wyłączona, gdyż stosowanie jej w komentarzach powodowało różnego rodzaju pomyłki.

Formatowanie treści wpisów lub treści komentarzy za pomocą Textile nie jest już dostępne, ale nie ma to wpływu na dotychczasowe wpisy i komentarze.

Dostępna składnia

Elementy blokowe

Akapity i podziały linii

Akapity (znaczniki <p/>) tworzone są z bloków tekstu, które oddzielone są za pomocą co najmniej jednej pustej linii lub linii zawierającej wyłącznie spacje lub wcięcia.

Podział linii (znacznik <br/>) tworzony jest w miejscu nowej linii odmiennie niż w przypadku klasycznego Markdowna, który wymagał poprzedzenia go co najmniej jedną spacją.

Nagłówki

Dostępne są dwie metody formatowania nagłówków (znaczniki: <h1/>, <h1/>, itd.):

Nagłówek pierwszego rzędu
=========================

Nagłówek drugiego rzędu
-----------------------
# Nagłówek pierwszego rzędu

## Nagłówek drugiego rzędu

Dla drugiego sposobu nagłówki pozostałych poziomów (1-6) tworzy się analogicznie.

Listy nieuporządkowane i uporządkowane

Listy nieuporządkowane (znaczniki: <ul><li/></ul>) można tworzyć za pomocą dowolnego ze znaków: gwiazdka (*), plus (+), pauza (-):

* lorem
* ipsum
* dolor

Listy uporządkowane (znaczniki: <ol><li/></ol>) tworzy się analogicznie, jednak w miejscu znaku powinna znaleźć się (dowolna) liczba z kropką:

1. lorem
2. ipsum
3. dolor

Listy nieuporządkowane i uporządkowane mogą zawierać dowolne formatowanie Markdown, a zatem mogą być również zagnieżdżane.

Bloki kodu

Preformatowane bloki kodu (znaczniki: <pre><code/></pre> tworzone są na podstawie tekstu poprzedzonego co najmniej czterema spacjami lub co najmniej jednym wcięciem.

    Przykładowy blok kodu

Formatowanie Markdown wewnątrz takiego bloku zostanie zignorowane.

Linie poziome

Linie poziome (znaczniki <hr/>) można tworzyć za pomocą powtórzonego co najmniej trzy razy dowolnego ze znaków znaków: pauza (-), gwiazdka (*), podkreślenie (_). Opcjonalnie, znaki te mogą być oddzielone spacjami. Przykłady:

***
* * *
**********
--------------------

Elementy liniowe

Odnośniki

Dostępnych jest kilka metod formatowania odnośników (znaczniki <a/>):

  • Standardowy odnośnik: [Tytuł](http://example.com/).
  • Odnośnik z etykietą ekranową: [Tytuł](http://example.com/ "Etykieta").
  • Odnośnik bez zdefiniowanego tytułu: <http://example.com/>.

Odnośniki do adresów e-mail zostaną dodatkowo zabezpieczone przed zautomatyzowanymi metodami zbierania adresów e-mail z witryn internetowych. Należy jednak pamiętać, że zabezpieczenie nie jest całkowicie skuteczne.

Istnieje także możliwość określania docelowego adresu URI za pomocą referencji.

Emfaza i silna emfaza

Emfazę (znacznik <em/>) i silną emfazę (znacznik <strong/>) można tworzyć za pomocą znaków: gwiazdka (*), podreślenie (_):

  • Emfaza: *emfaza*, _emfaza_.
  • Silna emfaza: **silna emfaza**, __silna emfaza__.

Wymienione znaki poprzedzone odwrotnym ukośnikiem są ignorowane.

Kod

Kod umieszczany wewnątrz bloku tekstu (znacznik <code/>) tworzy się za pomocą znaków słabego akcentu (`). Zdublowanie tych znaków po obydwu stronach formatowanego tekstu powoduje, że znajdujące się pomiędzy nimi pojedyncze znaki słabego akcentu są ignorowane.

  • Standardowy znacznik kodu: `kod`, ` kod `.
  • Rozszerzony znacznik kodu: ``kod ze znakiem `, czyli słabego akcentu``, `` kod ze znakiem `, czyli słabego akcentu ``.

Obrazki

Dostępnych jest kilka metod wstawiania obrazków (znaczniki <img/>):

  • Standardowy znacznik obrazka: ![Tekst alternatywny](http://example.com/image.png).
  • Znacznik obrazka z etykietą ekranową: ![Tekst alternatywny](http://example.com/image.png "Etykieta").

Formatowanie Markdown nie umożliwia zdefiniowania wymiarów obrazka.

Istnieje także możliwość określania adresu URI obrazka za pomocą referencji.

Linki zewnętrzne