Wprowadzenie do Markdown

Wprowadzenie do Markdown

Obniżka cen

Markdown to narzędzie do konwersji tekstu do HTML. Dziś stał się de facto-synonimem klasy lekkiego znacznika opisu języków. Używa zwykłej składni formatowania tekstu. Pomysł na Markdown polegał na tworzeniu pisania stron internetowych, a zwłaszcza wpisów na blogu tak łatwym jak pisanie e-maila. W czasach listopada 2017 r. Cel jest osiągnięty i oznaczony, a także jego pochodne ASCIIDOC, ASCIIDOCTOR i ASCIIDOCTOR-PDF.

Markdown koncentruje się tylko na zwykłym tekście i powstrzymuje się od wszystkich innych złożoności, jak znalezione w HTML. Łatwo się go nauczyć, ponieważ jest prosty, dlatego też szybciej, ponieważ używane są minimalne znaki, co prowadzi również do mniejszych szans na błąd. Podstawowy dokument pokazany w Edytorze Markdown znajduje się w Rysunku 1. Po lewej stronie widać kod źródłowy i po prawej stronie odpowiednie wyjście HTML. Możesz zauważyć, że nagłówki są po prostu oznaczone liczbą #według poziomu hierarchii nagłówka.

Konwersja tekstu

Zwykły tekst jest kabrioletu do XHTML (HTML) i wielu innych formatów za pomocą narzędzi wiersza poleceń, takich jak Markdown lub Pandoc. Zasadniczo oba narzędzia tworzą tylko fragmenty HTML i zapisują dane wyjściowe na stdout. Pandoc oferuje przełącznik „-O FILEN” do zapisania wyjścia HTML do danego pliku. Jak widać poniżej, plik wyjściowy nazywa się Basic.HTML i zawiera fragment HTML - dwa nagłówki i akapit.

$ pandoc -o basic.HTML Basic.MD
$ CAT BASIC.html

Tworzenie pakietów debian howto


Przedmowa


Odpowiedzialność za maszynę oznacza dbanie o sprzęt, a także komponenty oprogramowania. Jak widać w życiu codziennym jako administrator systemu, znacznie lepiej jest zainstalować oprogramowanie jako pakiet oprogramowania niż kilka plików źródłowych. Zmniejsza to koszty właściwego utrzymania systemu.
$

Aby utworzyć samodzielne dokumenty HTML z kompletnym nagłówkiem HTML Pandoc akceptuje przełącznik „-s” w następujący sposób:

$ pandoc -o basic.HTML -s Basic.MD
$ CAT BASIC.html










Tworzenie pakietów debian howto


Przedmowa


Odpowiedzialność za maszynę oznacza dbanie o sprzęt, a także komponenty oprogramowania. Jak widać w życiu codziennym jako administrator systemu, znacznie lepiej jest zainstalować oprogramowanie jako pakiet oprogramowania niż kilka plików źródłowych. Zmniejsza to koszty właściwego utrzymania systemu.

Zaletą utrzymywania oddzielania treści od wyświetlacza wizualnego jest to, że nie zepsuje wyglądu Twojej witryny. Wersja 1.0.1, który został opracowany przez Johna Grubera i Aarona Swartz, został wydany w grudniu 2004 roku i jest dostępny jako bezpłatne oprogramowanie (patrz linki na końcu tego artykułu).

Elementy tekstowe

Nagłówki

Zgodnie z odpowiednim poziomem HTML, nagłówki są napisane z liczbą #S w następujący sposób:

# H1
## H2
### H3
#### H4
##### H5
###### H6

Dla H1 i H2 zaakceptowane są dwa alternatywne sposoby pisania:

H1
==
H2
--

Należy pamiętać, że liczba równych znaków lub krewek musi pasować do liczby znaków nagłówka.

Podkreślenie tekstu

Aby podkreślić tekst, elementy są obsługiwane:

  • Kursywa: pojedyncze gwiazdki lub pojedyncze podkreślenia
    --
    * WAŻNE* i _ MAJEM WAŻNY_
    --
  • Bold Tekst: podwójne gwiazdki lub podwójne podkreślenia
    --
    ** WAŻNE ** i __ MIEJSCE WAŻNE
    --
  • Skrzyżowany tekst: podwójne tydle
    --
    ~~ Text ~~
    --

Listy

Markdown obsługuje listy nieuporządkowane i uporządkowane. Uporządkowane listy zaczynają się od gwiazdka, plus lub znak minus. Uporządkowane listy zacznij od cyfry. Aby utworzyć subliści wcięcie listy według dwóch przestrzeni (Markdown, Stackedit) lub czterech przestrzeni (pandoc), jak patrzysz poniżej:

1. owoce
* jabłko
* banan
2. napoje
+ woda
+ mleko

Obrazy

Najłatwiejszym sposobem jest użycie stylu wbudowanego w następujący sposób:

![Logo Debian] (Debian-logo.PNG „Logo Debian”)

To wyświetla odwołany obraz. Jak tylko przesuniesz wskaźnik myszy na obraz, widać odpowiedni tekst opisu.

Podświetlenie kodu i składni

Istnieją dwa warianty - kod wbudowany i bloki kodu. Kod rzędowy jest w ramach trzech back -to, takich jak „” („Witaj, świat!”)„ ”. Bloki kodu również zaczynają się i kończą z trzema tworzeniem back, ale na osobnych liniach w następujący sposób:

"
Drukuj („Cześć, świat!”)
"

Markdown nie obsługuje podświetlania składni, ale dialekty takie jak Markdown tutaj.

Tabele

Markdown nie obsługuje tabel, ale rozszerzenia, takie jak GFM i Markdown tutaj.

Cytaty blokowe

Blokady zacznij od znaku „>”. Przydatne jest cytowanie tekstu.

> "Och! Absurdalne jest posiadanie twardej i szybkiej zasady dotyczące tego, co należy
> Przeczytaj i czego nie należy. Zależy ponad połowa współczesnej kultury
> O tym, czego nie należy czytać."
>
> Znaczenie bycia poważnym. (Oscar Wilde)

Spinki do mankietów

Linki odnoszą się do innych dokumentów lub sekcji w bieżącym. Styl pisania jest podobny do obrazów i składa się z opisu linku w nawiasach kwadratowych i adresu URL w regularnych nawiasach.

[Jestem linkiem w stylu wbudowanym] (https: // linuxhint.com)

Ponadto możesz dodać alternatywny tekst:

[Jestem linkiem w stylu wbudowanym z dodatkowym tekstem] (https: // linuxhint.com „Linuxhint”)

Linki można odwoływać w następujący sposób:

[Linuxhint] [1]

jakiś tekst

[1]: https: // linuxhint.com

Umożliwia to łatwe tworzenie list referencji na końcu dokumentu, ponieważ jest to powszechne w dokumentach naukowych.

Wniosek

Markdown jest dość prosty i obowiązkowy dla każdego, kto dokonuje dokumentacji i regularnie publikuje treść. Użycie go jest wielką przyjemnością.

Bibliografia

  • Stackedit, https: // stackedit.io
  • Pandoc, http: // pandoc.org/
  • Markdown, https: // dainingfireball.Net/Projects/Markdown/
  • Markdown Cheatsheet, https: // github.com/adam-p/markdown-here/wiki/markdown-cheatsheet