Własny instruktarz do Markdown

Elementy zblokowane

Paragrafy i dzielenie linii

W Markdown paragrafy są oznaczone dwoma lub większą liczbą pustych linii. Typora, której osobiście używam, nowy paragraf tworzony jest przez pojedynczą pustą linię. W Typora złamanie linii osiągniemy poprzez Shift+ Return. Wiele programów przetwarzających będzie ignorowało złamanie linii, aby zapewnić zgodność na końcu linii zostawiamy dwie spacje lub stosujemy znacznik <br/>.

Nagłówki

Nagłówki poziomu 1 - 6 tworzymy za pomocą znacznika # poprzedzając nim linię.

Cytaty wyróżnione

Aby utworzyć wyróżniony blok tekstu należy poprzedzić go znakiem większe od: >.

Listy

Listy nieuporządkowane

Wystarczy linię poprzedzić znakiem: *. Alternatywnie wykorzystać można również + czy znak -. Lista może zawierać więcej poziomów co osiągamy wcinając linię przed kolejnym znakiem *.

Listy uporządkowane

Listy uporządkowane tworzymy rozpoczynając linię od liczby np.: 1.

Listy zadań

Tworzymy poprzedzając linię [ ] dla zadań niewykonanych lub [X] dla zadań wykonanych.

Ogrodzony blok kodu

Blok kodu tworzymy zamykając kod między znacznikami ```, tworzą one z obu stron kodu ogrodzenie. Znaczniki ogrodzenia występują samodzielnie na oddzielnych liniach. Możliwe podświetlenie składni po podaniu języka bezpośrednio po otwarciu, przykład: ```ruby.

Blok z wzorami matematycznymi

Otwieramy i zamykamy znacznikami $$. Wewnątrz bloku używamy wyrażeń LaTeX. I gra muzyka

Tabele

Tabele utworzymy wpisując: |pierwszy nagłówek|drugi nagłówek| a następnie wciskając Enter. A na następujące linii: |---------------|---------------| . Podobnie wpisujemy elementy tabeli w kolejnych liniach. Więcej, możemy w linii 'z kreseczkami' za pomocą dwukropku zadać dosunięcie tekstu do lewa, prawa lub centrowanie: |:--------| oznacza tekst równany do lewej, dla centrowanego byłoby: |:--------:|.

Przypisy

Przypisy pojawiające się jak najedziemy myszką na odnośnik, oznaczamy [^odnosnik1] a gdzieś pod spodem definiujemy: [^odnosnik1]: ten tekst się pojawi.¹Albo możemy wrzucić adres stronki jak do Wydziału Biologii².

Linie rozdzielające

Otrzymamy wklepując --- albo *** a następnie Enter. Jak poniżej zademonstrujemy:

Spis treści

Wpisujemy [toc], dajemy Enter i tworzy się tam spis treści.

Elementy Liniowe

Linki

Są różne rodzaje linków. Tekst wyświetlany umieszczamy w nawiasie kwadratowym. Adres docelowy w nawiasie zwykłym. I tak Wydział Biologii, otrzymamy wklepując [Wydział Biologii](https://www.biol.uw.edu.pl).

Możemy tu zalinkować inny dokument? - sprawdzamy test. Odpowiedź na nasze pytanie jest więc twierdząca.

Można też dać tytuł linku, który się pojawi gdy wskaźnik unosi się nad linkiem: [Wydział Biologii](https://www.biol.uw.edu.pl "Super miejsce"). Testujemy: Wydział Biologii.

Linki - zakładki możemy też linkować do sekcji dokumentu, które są oznaczone nagłówkami, przykład: Tabele, inny.

Linki - typu referencja, w linkach tego typu sam adres jest wskazany w innym miejscu a linkowi tylko nadaje się imię. Przykładowo: This is [an example][id] reference-style link. A w dowolnym innym miejscu dokumentu możemy zdefiniować: [id]: http://example.com/ "Optional Title Here".

URL można podawać url jako linki po objęciu ich nawiasem < >. Np.: www.interia.pl

Ilustracje

Podobna składnia do linków, tyle że dodany na starcie znak !. Więc wklejenie ilustracji wygląda następująco: ![Alt text](/path/to/img.jpg "Optional title"). Przykład działający: Skalowanie możliwe tylko przy wykorzystaniu znaczników html.

Co wygląda następująco <img src="H:\notatnik\ilustracje\komar.svg" style="zoom:25%;" />

Podejrzyj kod pod rysunkami, kliknij na nie aby zobaczyć jak określić położenie relatywnie do dokumentu, aby nie groziło nam nieporozumienie po przeniesieniu dokumentu w inne miejsce.

Tekst wyróżniony

Do wyróżniania tekstu służą * lub _. Pojedyncze dają emfazę, podwójne silne zaznaczenie. Rekomenduje się używanie *. Kiedy z jakiegoś powodu musimy uciec ze znaczenia znacznikowego do samego znaku używamy \ - slasza. Przykład *Ten tekst nie jest ani pogrubiony, ani italikiem. Po prostu jest otoczony gwiazdkami*.

Kod

Kod wewnątrz paragrafu otrzymujemy ujmując fragment linii w nawias ze znaków- ` -poczyniony. Jak w przykładzie print(2+5).

Przekreślony tekst

Jak w przykładzie, tworzymy za pomocą nawiasu utworzonego z ~~. I teraz przykład damy ciekawy.

Tekst podkreślony

Do tego musimy wykorzystać surowy html to będzie tekst podkreślony, mam nadzieję.

Tekst podświetlony.

Opcja, wymaga odhaczenia w edytorze - interpretatorze, kiedy już jest to ją mamy.

Nadtekst i Podtekst

To są również opcje niestandardowe. Podtekst daje nam tylda. I tak H₂O, CH₄

Natomiast nadtekst daje nam jak zywkle ^. I tak napiszemy sobie: hop siup na kanpie^*8.

Emoji

Również opcja. Działa po wpisaniu np. ​:smiley_cat:.

😠, 😿, 🎉, 💃

Nie robią jakiegoś niesamowitego wrażenia.

Matematyka w zdaniu

W zdaniu po uaktywnieniu - opcja, treść zawarta między znacznikami dolara $.

I tak możemy napisać: $x=\frac{a}{b}$

HTML

Aby otrzymać inne efekty wykorzystajmy zwykły kod html, np this text is red

Opcje zaawansowane, np tworzenie diagramów