Hoe te schrijven met Markdown en de verschillen met HTML.

Binnenkomen

van alinea.
In Markdown is het net zo eenvoudig als in een normale editor.
Bovendien hebben we het voordeel dat een enkele regeleinde de tekst niet in meerdere regels scheidt, als we zoiets als dit schrijven:

 Een tekst. Nog een tekst.

 Een tekst. Nog een tekst.

,

, enz., van kop.
In Markdown is het heel eenvoudig, je hoeft alleen maar het cijferteken (#) als voorvoegsel in de koptekst te plaatsen, hoe meer hiervan, hoe lager de kop, tot een maximum van 6.
Bijvoorbeeld een kop (de grootste) en een ze zouden als volgt worden geschreven:

 # Grote kop ### Kleine kop

en het resultaat zal als volgt zijn.

Geweldige kop
Kleine kop

scheidingstekens
Scheidingstekens zijn normaal gesproken niet mogelijk om in eenvoudige editors te tekenen.

VERGROTEN

In HTML worden ze van horizontale regels.
Ze worden gescheiden door 3 of meer sterretjes of koppeltekens te typen. Ze kunnen worden gevolgd of gescheiden door een spatie, het is onverschillig.

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

Nadruk
Deze opmaak staat bekend als cursief en vet.
In HTML zou het zijn Y .
Om tekst cursief te maken, hoeft u alleen maar de tekst tussen enkele sterretjes of onderstrepingstekens te plaatsen, en voor vetgedrukt tussen dubbele:

 * cursieve tekst. * _ cursieve tekst._ ** vetgedrukte tekst ** __vetgedrukte tekst .__

Het zou er ongeveer zo uitzien:
cursieve tekst. vetgedrukte tekst.
doorhalen
Hiermee kun je tekst plaatsen alsof we het doorstrepen, veel gebruikt voor versiebeheer. o Bugs die zijn gecorrigeerd in een applicatie of systeem.
IN HTML zou het van doorhalen zijn.
Het is voldoende om de tekst tussen dubbele hoofdletters of tildes te plaatsen:

 ~~ doorgestreepte tekst. ~~

Deze optie is geen standaard en werkt mogelijk niet in alle editors.
Citaten
De citatiestijl is meestal niet gemakkelijk te vinden in een gewone teksteditor
In HTML zou het zijn

.
We hoeven alleen het teken "groter dan" (>) als voorvoegsel te plaatsen voor de tekst die volgt (vergelijkbaar met de adressering in linux)

 > Dit is een citaat.

Het zou eruit zien:

Dit is een citaat.

Lijsten
Om een ​​lijst met doelstellingen te definiëren, gebruiken we meestal de functionaliteit van opsommingstekens voor lijsten zonder specifieke volgorde en genummerde lijsten.
In HTML zou het zijn voor ongeordende lijsten, voor geordende lijsten en om elk item in de lijst te definiëren.
In Markdown definiëren we ze eenvoudig door elk item vooraf te laten gaan door een asterisk (*), streepje (-) of plusteken (+) voor ongeordende lijsten. Voor geordende lijsten prefixen we met het bijbehorende nummer en een punt:

 * Schrijf tutorial * Publiceer het in Solvetic. 1. Nieuwe zelfstudie. 3. Kies een sectie en niveau. 2. Corrigeer formaten en publiceer.

Het zou er als volgt uitzien:

• Zelfstudie schrijven.
• Post het op Solvetic.

• Nieuwe zelfstudie.
• Kies een sectie en niveau.
• Corrigeer formaten en publiceer.

In opgesomde lijsten wordt de hiërarchie van het nummer niet gerespecteerd, de positie daarbinnen wordt gebruikt.
Links
Het plaatsen van koppelingen is uiterst nuttig en belangrijk, omdat u hiermee naar inhoud kunt verwijzen naar externe documentatie of een zelfstudie.
Voorbeeld:

 Nginx-server is beveiligd met fail2ban met behulp van [tutorial-solvetic] (http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo-con-ssh-y-nginx/)

We zetten tussen haakjes [] de tekst die we willen heeft de link en dan plaatsen we tussen haakjes () de bestemmingslink.
Als je het liever op een meer geordende manier doet dan de verwijzingen in het midden van je tekst te hebben, dan kan dat ook op de volgende manier:

 Nginx-server is beveiligd met fail2ban met behulp van [1]……… [1]: http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo-con-ssh-y-nginx /

Een andere optie zou zijn:

 Nginx-server is beveiligd met fail2ban met behulp van [fail2ban-nginx-solvetic]……… [ssh-nginx-solvetic]: http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo - con-ssh-y-nginx /

Voeg nu afbeeldingen toe.
Afbeeldingen
We kunnen afbeeldingen toevoegen die bijna lijken op links door een! Voor elk moet ik benadrukken dat ik ze niet vanaf een terminal kan zien, nou ja, niet direct.

 ! [alternatieve tekst] (afbeelding-url)

We kunnen dezelfde opties van de links gebruiken als we het overzichtelijker willen hebben.
Borden
Ik zet meestal toegangsgegevens in tabellen van servers of services.
Om dit te doen, tekenen we de lijnen van de tabel met pijpen (|) om de kolommen en koppeltekens (-) af te bakenen om de kop van de rest van de rijen te scheiden:

 | Dienst | Gebruiker | Sleutel | | ------------- | --------- | ----------- | | FTP | oplossend | aw-D.wak | | SSH | admin | 2 -.- am, |

We zouden zoiets hebben als dit:

De leidingen hoeven niet uitgelijnd te worden en de "randen" zijn optioneel, bijvoorbeeld:

 Rubriek 1 | Kop 2 --- | --- laten we proberen | iets laten we wat proberen | iets anders. Dit zou dezelfde tabel genereren. 

U kunt de tekst in uw kolommen ook uitlijnen door het dubbele puntsymbool ( op het koppelteken gemaakt scheidingsteken aan de kant die u wilt opstellen:

 | Links uitgelijnd. | Gecentreerd | Rechts uitgelijnd. | |: ------------------- |: --------: | ----------------- -: | | testen | testen | testen |

Niet alle editors accepteren tabellen in Markdown.
Code
We kunnen onze code markeren met markdown en deze verschilt van taal tot taal.

Syntaxis van drievoudige backtick

Het plaatsen van dit type blokken is heel eenvoudig, we hoeven alleen het codeblok dat we willen invoeren in te sluiten.e 3 backticks (`` ``) gevolgd door de naam van de taal waartoe de code die u wilt plaatsen behoort:

 `` `taal x = y …` ``

Een voorbeeld van JavaScript-code ziet er ongeveer zo uit:

 `` `` js functietest () {console.log ('testen!')} ''

Dit zou een mooi codeblok genereren met syntaxis gemarkeerd voor javascript:

 functietest () {console.log ('testen!')}

Syntaxis voor spatiëring

Een andere manier om vooraf opgemaakte tekst of code te plaatsen, maar zonder gespecificeerde taal, is door onze tekst te "inspringen" met 4 spaties, we zouden het als volgt schrijven:

 x = y // merk op dat er 4 spaties zijn tussen de marge en wat we schrijven.

we zullen dit resultaat hebben:

 x = y // merk op dat er 4 spaties zijn tussen de marge en wat we schrijven.

De standaard accepteert alleen de optie met voorspaning.
conclusiesEen goed Documentatiesysteem moet snel, flexibel en eenvoudig zijn. Punten die markdown op een zeer goede manier dekt, we mogen de schone syntaxis voor de ogen niet vergeten, iets om rekening mee te houden als we de documentatie van een terminal willen bekijken die VIM / EMACS gebruikt. Het item heeft een aanpak voor systeembeheerders, maar het kan erg handig zijn voor alle soorten professionals of studenten. Ik hoop dat elke twijfel of suggestie duidelijk is gemaakt, laat het in de reacties achter.Vond je deze Tutorial leuk en heb je eraan geholpen?Je kunt de auteur belonen door op deze knop te drukken om hem een ​​positief punt te geven