Markdown: Różnice pomiędzy wersjami

Z JoggerWiki
Skocz do: nawigacji, wyszukiwania
m (Akapity i podziały linii)
m (Listy nieuporządkowane i uporządkowane)
Linia 40: Linia 40:
 
Nagłówki pozostałych poziomów tworzy się analogicznie.
 
Nagłówki pozostałych poziomów tworzy się analogicznie.
  
==== Cytaty blokowe ====
+
==== Listy nieuporządkowane i uporządkowane ====
  
Tworzenie cytatów blokowych (znaczniki <code>&lt;blockquote/&gt;</code>) jest analogiczne do metody przyjętej do cytowania fragmentów wiadomości e-mail lub wiadomości grup dyskusyjnych:
+
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>&gt; Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor
+
<pre>* lorem
incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis
+
* ipsum
nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</pre>
+
* dolor</pre>
  
Cytaty blokowe mogą zawierać dowolne formatowanie Markdown, a zatem mogą być również zagnieżdżane.
+
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 i uporządkowane ====

Wersja z 13:52, 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

Nagłówki pozostałych poziomów 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.

Listy nieuporządkowane i uporządkowane

Listy nieuporządkowane (znaczniki: <ul><li/></ul>) można tworzyć za pomocą dowolnego ze znaków 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 blogu 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