Laajennukset | .md, .markdown |
---|---|
MIME-tyyppi | text/markdown |
PUID | fmt / 1149 |
Kehittäjä | Aaron Swartz , John Gruber |
Alkuperäinen versio | 19. maaliskuuta 2004 |
Formaatin tyyppi | Merkintäkieli |
Verkkosivusto | (en) daringfireball.net/projects/markdown |
Markdown on kevyt kuvauskieli luotu 2004 mennessä John Gruber avustuksella Aaron Swartz . Se on luotu tarkoituksena tarjota helppo lukea ja kirjoittaa syntaksia . Markdown-merkitty asiakirja voidaan lukea sellaisenaan ilman, että se olisi merkitty tai muotoiltu erityisillä ohjeilla.
Markdown-merkitty asiakirja voidaan muuntaa HTML- , PDF- tai muiksi muodoiksi. Vaikka useat olemassa olevat teksti-HTML-muunnossuodattimet - kuten Setext , atx, Textile , reStructuredText , Grutatext ja EtText - ovat vaikuttaneet Markdown-syntaksiin, Markdownin tärkein inspiraation lähde on tekstipohjainen sähköpostimuoto .
John Gruberin alkuperäisestä luomisesta lähtien Markdown ei ole kokenut merkittävää kehitystä tekijöiltään. Lisäksi tätä muotoa ei ole koskaan virallisesti standardoitu.
Jotkut muut ovat sen vuoksi kehittäneet tietyn määrän muunnelmia voidakseen voittaa hyvin yksinkertaistetulle syntaksille ominaiset rajoitukset.
Esimerkkejä ovat MultiMarkdown ja GitHub Flavored Markdown . Jälkimmäistä käytetään GitHubin artikkeleihin ja dokumentointiin , mutta se on myös laajalti otettu käyttöön useissa tekstieditorissa, jotka tukevat Markdownia syntaksin korostus- tai esikatselutasolla.
Mukana on myös laajennuksia monille ohjelmistoille, kuten " Markdown Here " Firefoxille ja Chromelle . WordPress- sisällönhallintajärjestelmä integroi luonnollisesti joitain tämän kielen osia version 4.3 jälkeen.
Maaliskuussa 2016 julkaistiin kaksi RFC: tä standardointia varten:
Vuonna 2012 aloitetun CommonMark-aloitteen tavoitteena on korjata standardoinnin puute ja muodon epäselvyydet luomalla tarkasti määritelty kielimääritys. Sitä käyttävät nyt muun muassa Discourse, GitLab, Reddit, Qt, Stack Overflow ja Stack Exchange.
Useita toteutuksia on olemassa ja tämä eri ohjelmointikielillä : Perlissä , PHP: ssä , Ruby: ssa , Pythonissa , Javassa , C #: ssa , Haskellissa , Gambasissa , R: ssä ja jopa JavaScriptissä , erityisesti strapdown.js: n avulla. Swiftin versiosta 2.0 lähtien on myös mahdollista käyttää Markdownia leikkikentilläsi .
Kevyttä Markdown-merkintäkieliä käytetään monissa sovelluksissa, joko ohjelmisto- / koodieditorissa, kirjoitusohjelmistossa, koodialustalla tai jopa muokkausketjuissa lisäämällä muita ohjelmistoja. Kyseiset alueet voivat olla tietokonekehitys (Markdownia käytetään yleensä ohjelman lähdekoodia kuvaavan README-tiedoston muotoilemiseen ), teknisen dokumentaation kirjoittaminen tai jopa akateeminen julkaisu.
Se on myös monien yhteistyökirjoittavien alustojen, kuten Authorea tai Manubot, valitsema merkintäkieli. Markdown-tiedostojen kirjoittamiseen verkossa on useita ohjelmia, kuten CodiMD, Etherpad tai Firepad.
Tässä on joitain esimerkkejä Markdown-syntaksista. Annetaan vastaavat HTML-tunnisteet. Tämä luettelo ei ole tyhjentävä.
Markdownissa korostus on vaihdettavissa merkkien kanssa _ja *käytetään pareittain, mikä mahdollistaa koodin paremman luettavuuden, jos sitä käytetään oikein. Painopisteitä on kolme.
Voit korostaa tekstiä (HTML <em> -tagi), joka johtaa kursivointiin nykyisessä selaimessa:
*quelques mots*tai:
_quelques mots_Tekstin korostamiseksi (HTML <strong> -tagi), joka tuottaa taivutuksen nykyisessä selaimessa, käytämme kaksoisparia ( __tai **):
**plus important**tai:
__également important__Tekstin asettaminen viimeiselle korostustasolle (HTML-tunniste <strong> ja <em>), joka tuottaa lihavoitua ja kursiivia nykyisessä selaimessa:
___très important___tai:
_**tout aussi très important**_Koodin lisääminen tekstiin (HTML <code> -tagi):
(Huomaa: merkki `on vakava aksentti (englanninkielinen backtick ), oletusarvoisesti ranskalaisessa AZERTY-AltGr + 7 näppäimistössä )
Mon texte `code` fin de mon texteTai useilla riveillä, joissa on syntaksikorostus etuliitetyn kielen mukaan:
(Huomaa: merkki `on vakava aksentti (englanninkielinen backtick ), oletusarvoisesti ranskalaisessa AZERTY-AltGr + 7 näppäimistössä )
```php Mon code PHP en couleurs sur plusieurs lignes ```Laita koodilause varten neljä välilyöntiä eteen:
Première ligne de code Deuxième ligneKuten sähköpostiviesteissä, on mahdollista tehdä lainauksia:
> Ce texte apparaîtra dans un élément HTML <blockquote>.Jos haluat tehdä uuden kappaleen (HTML <p> -tagi), ohita kaksi riviä, ts. Jätä tyhjä rivi kahden kappaleen väliin. Yhden rivin ohittaminen alkuperäisessä tekstissä ei vaikuta näyttöön (näyttö on jatkuva).
Premier paragraphe Deuxième paragrapheTee yksinkertainen uusi rivi asettamalla rivin loppuun kaksi välilyöntiä (HTML <br> tag).
Ohita rivi ennen luettelon alkua.
Järjestämättömän luettelon (HTML <ul> -tagin) luominen:
* Pommes * Poires * Sous élément avec au moins quatre espaces devant.Ja järjestetty luettelo (HTML <ol> -tagi):
1. mon premier 2. mon deuxièmeJa luettelo valintaruudun tilassa
- [ ] Case non cochée - [x] Case cochéeOtsikot luodaan niin monta #(ristiä ) ennen otsikkoa, joka vastaa haluttua otsikkotasoa ( HTML tarjoaa 6 otsikkotasoa <h1> - <h6>)
# un titre de premier niveau #### un titre de quatrième niveauKahdelle ensimmäiselle otsikkotasolle (<h1> ja <h2>) on myös mahdollista alleviivata otsikko painikkeella =tai -(niiden todellisella lukumäärällä ei ole merkitystä, mutta sen on oltava suurempi kuin 2).
Titre de niveau 1 ===================== Titre de niveau 2 -------------------Taulukoiden luominen (HTML <tr> ja <th> -tagit)
| Titre 1 | Titre 2 | Titre 3 | | :------------ | :-------------: | -------------: | | Colonne | Colonne | Colonne | | Alignée à | Alignée au | Alignée à | | Gauche | Centre | Droite |Linkkien luominen (HTML <a> -tagi):
[texte du lien](url_du_lien "texte pour le titre, facultatif")(Huomaa: sulkeutuvan sulun ja avaavan sulun välissä ei ole tilaa. Sinun on kirjoitettava ..link] (url .. eikä ..link] (url ..)
Kuvan (HTML <img> -tagin) näyttäminen:
(Huomaa: sulkeutuvan sulun ja avaavan sulun välissä ei ole tilaa. Sinun on kirjoitettava ..link] (url .. eikä ..link] (url ..)