Hvordan skrive med Markdown og dens forskjeller med HTML.

Hva er Markdown
Det er definert så mye som programvare skrevet inn Perl, som konverterer teksten skrevet til HTML og i tillegg til syntaksen som brukes for å nå HTML -resultatet vi forventer. En syntaks designet for å være enkel for alle som ønsker å skrive på nettet, uten behov for kunnskap om det.
I dag støtter de fleste innholdsforvaltere og til og med mange e -postklienter bruk av Markdown -syntaks, innfødt dette med den hensikt å lette opprettelsen av formatert tekst uten å måtte implementere stiler eller kjenne HTML. Disse behandlerne bruker en parser for å konvertere Markdown -tekst til HTML.
MarkDown og dokumentasjon
Det er veldig nyttig å lære mange dokumentasjonsverktøy fra markdown; wikia, onenote, evernote, alfresco støtter det innfødt, eller ved hjelp av tredjeparter. Det er viktig å ha dokumentasjon på prosessene og mulige problemer, men enda viktigere er det å holde det pent og rent selv fra konsollen, og markdown er her for å hjelpe oss med det.
Avsnitt
Hvis vi skrev normalt i en vanlig redaktør, for å definere et avsnitt, ville vi ganske enkelt trykke på et par av:

Tast inn

Og vi vil se markøren gå et par linjer nedenfor for å skrive i et nytt avsnitt.
I HTML er det kjent som

av avsnitt.
I Markdown er det like enkelt som i en vanlig redaktør.
I tillegg har vi fordelen at et enkelt linjeskift ikke skiller teksten til flere linjer, hvis vi skriver noe slikt:

 En tekst. En annen tekst.
Det vil se slik ut:
 En tekst. En annen tekst.
Ved å bruke flere skillelinjer reduseres det på samme måte til et enkelt skillelinje mellom avsnittene
Overskrifter
I en vanlig editor trenger vi verktøylinjen for å definere en overskriftsstil for en tekst, eller hvis du føler deg litt rotete, ville det være nok å gå opp til skriftstørrelsen og gjøre den fet.
I HTML er de kjent som

,

, osv., fra topptekst.
I Markdown er det veldig enkelt, du må ganske enkelt plassere talltegnet (#) som et prefiks til overskriften, jo flere av disse har lavere grad at overskriften vil være opptil maksimalt 6.
For eksempel en overskrift (den største) og en de ville være skrevet slik:
 # Big header ### Small header
og resultatet blir slik.

Flott header
Liten overskrift

Separatorer
Skilletegn er normalt ikke mulig å trekke inn enkle redaktører.

FORSTØRRE

I HTML blir de av horisontale regler.
De er avgrenset ved å skrive 3 eller flere stjerner eller bindestreker. De kan følges eller skilles av et mellomrom, det er likegyldig.
 * * * *** - - - ---
Vektlegging
Denne formateringen er kjent som kursiv og fet skrift.
I HTML ville det være Y .
For å lage tekst med kursiv format, trenger du bare å omgi teksten mellom enkeltstjerner eller understreker, og for fet skrift mellom dobbeltrom:
 * kursiv tekst. * _ kursiv tekst. _ ** fet tekst. ** __ fet tekst .__
Det ville se slik ut:
kursiv tekst. fet tekst.
Gjennomstrømning
Dette lar deg plassere tekst som om vi skulle krysse den av, brukt mye for versjonskontroll. o Bugs som ble korrigert i et program eller system.
I HTML ville det være fra gjennomstikk.
Det er nok å omgi teksten mellom to store eller store bokstaver:
 ~~ gjennomsiktig tekst. ~~
Dette alternativet er ikke en standard og fungerer kanskje ikke i alle redaktører.
Sitater
Siteringsstilen er vanligvis ikke lett å finne i en vanlig tekstredigerer
I HTML ville det være
.
Vi må bare plassere "større enn" -tegnet (>) som et prefiks til teksten som følger (ligner adresseringen i linux)
 > Dette er et sitat.
Det ville se ut:

Dette er et sitat.


Lister
For å definere en liste med mål bruker vi vanligvis funksjonaliteten til kuler for lister uten spesifikk rekkefølge og nummererte lister.
I HTML ville det være for uordnede lister, for bestilte lister og for å definere hvert element i listen.
I Markdown definerer vi dem ved å prefiksere hvert element med en stjerne (*), bindestrek (-) eller plussymbol (+) for uordnede lister. For bestilte lister prefikser vi det tilsvarende tallet og et punkt:
 * Skriv opplæring * Publiser den på Solvetic. 1. Ny opplæring. 3. Velg en seksjon og nivå. 2. Rett formater og publiser.
Det ville se slik ut:
  • Skriv opplæring.
  • Legg det ut på Solvetic.
  • Ny opplæring.
  • Velg en seksjon og et nivå.
  • Korrekte formater og publiser.
I opplistede lister blir ikke hierarkiet til tallet respektert, posisjonen i dem vil bli brukt.
Lenker
Å plassere lenker er ekstremt nyttig og viktig siden det lar deg referere innhold til ekstern dokumentasjon eller en opplæring.
Eksempel:
 Nginx-serveren er sikret med fail2ban ved hjelp av [tutorial-solvetic] (http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo-con-ssh-y-nginx/)
Vi legger i parentes [] teksten vi ønsker har koblingen, og så plasserer vi mellom parenteser () destinasjonslenken.
Hvis du foretrekker å gjøre det på en mer ryddig måte enn å ha referansene i midten av teksten, kan du også gjøre det på følgende måte:
 Nginx-serveren er sikret med fail2ban ved hjelp av [1] ……… [1]: http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo-con-ssh-y- nginx/
Et annet alternativ ville være:
 Nginx-serveren er sikret med fail2ban ved hjelp av [fail2ban-nginx-solvetic] ……… [ssh-nginx-solvetic]: http://www.solvetic.com/tutoriales/article/1963-instalar-fail2ban-y-asociarlo- con-ssh-y-nginx /
Legg til bilder nå.
Bilder
Vi kan legge til bilder som nesten ligner på lenker ved å legge til en! Før hver enkelt må jeg understreke at jeg ikke kan se dem fra en terminal, vel ikke direkte.
 ! [alternativ tekst] (image-url)
Vi kan bruke de samme alternativene for koblingene hvis vi vil ha det mer organisert.
Tavler
Jeg legger vanligvis tilgangsdata i tabeller over servere eller tjenester.
For å gjøre dette tegner vi linjene i tabellen med rør (|) for å avgrense kolonnene og bindestrekene (-) for å skille overskriften fra resten av radene:
 | Tjeneste | Bruker | Nøkkel | | ------------- | --------- | ----------- | | FTP | solvetic | aw-D.wak | | SSH | admin | 2 -.- am, |
Vi ville ha noe slikt:

Rørene trenger ikke justeres, og "kantene" er valgfrie, for eksempel:
 Overskrift 1 | Overskrift 2 --- | --- la oss prøve | noe la oss prøve litt | Dette ville generere den samme tabellen. 
Du kan også justere teksten i kolonnene dine ved å plassere kolon -symbolet (:) på bindestrek laget separator på siden du vil ha i rekkefølge:
 | Venstrejustert. | Sentrert | Innrettet til høyre. | |: ------------------- |: --------: | ----------------- -: | | test | test | test |
Ikke alle redaktører godtar tabeller i Markdown.
Kode
Vi kan markere koden vår med markdown, og den er forskjellig fra ett språk til et annet.

Trippel backtick -syntaks


Det er veldig enkelt å plassere denne typen blokker, vi må bare legge ved koden som vi vil legge inn.e 3 backticks (`` ``) etterfulgt av navnet på språket som koden du vil plassere tilhører:
 `` språk x = y … ''
Et eksempel på JavaScript -kode vil se slik ut:
 `` `` js function test () {console.log ('testing!')} ''
Dette ville generere en fin kodeblokk med syntaks uthevet for javascript:
 funksjonstest () {console.log ('testing!')}

Syntaks før avstand


En annen måte å plassere forhåndsformatert tekst eller kode på, men uten spesifisert språk er ved å "innrykke" teksten vår med 4 mellomrom, vi ville skrive den slik:
 x = y // legg merke til at det er 4 mellomrom mellom margen og det vi skriver.
vi får dette resultatet:
 x = y // legg merke til at det er 4 mellomrom mellom margen og det vi skriver.
Standarden godtar bare alternativet med forhåndsinnstilling.
KonklusjonerEt godt dokumentasjonssystem må være raskt, fleksibelt og enkelt. Punkter som markdown dekker på en veldig god måte, vi må ikke glemme den rene syntaksen for øynene, noe å ta i betraktning hvis vi vil gå gjennom dokumentasjonen fra en terminal ved hjelp av VIM / EMACS. Oppføringen har en tilnærming for systemadministratorer, men den kan være veldig nyttig for alle typer fagpersoner eller studenter. Jeg håper enhver tvil eller forslag har blitt gjort klart, la det stå i kommentarene.Likte og hjalp du denne opplæringen?Du kan belønne forfatteren ved å trykke på denne knappen for å gi ham et positivt poeng

wave wave wave wave wave