szintaxis árleszállítás

Árleszállítás úgy tervezték, hogy egyszerű és olvasni és írni, amennyire csak lehetséges.

Olvashatóság, azonban hangsúlyozni mindenek felett. Árleszállítás dokumentum formátum kell tekinteni, ahogy van, a sima szöveg, amely nem elkapni a szem bármely tag vagy formázási utasítást. Markdown szintaxis befolyásolták több meglévő szöveges szűrők HTML (beleértve Setext. ATX. Textil. ReStructuredText. Grutatext. És EtText) és a legnagyobb inspirációt árleszállítás szintaxis volt egyszerű szöveges e-maileket.

Ezért Markdown szintaxis, amely teljes írásjel és írásjelek, amelyeket gondosan kiválasztott, hogy néz ki, mit jelentenek. Például csillagok körül egy szó valójában vonzza a # 42; fiók # 42; 1. Markdown listák néz ki, jól, mint listákat. Még a idézetek kinéznie idézetek szövegrészletet ismerős, ha valaha is használt e-mail.

Insert HTML

Ahhoz, hogy hozzon létre egy elrendezést, amely Markdown szintaxis nem ad, akkor csak a HTML is. Nincs szükség, hogy lezárja a HTML speciális elválasztó elérni váltás Markdown HTML; elég ahhoz, hogy elkezd használ HTML.

Az egyetlen megkötés, hogy a moduláris elemek a HTML (azaz

, ,
, 

és így tovább. n.) kell elválasztani üres sorokat a környező szöveget, a kezdő és záró tag nem térhet el a sor elejére. Árleszállítás smetliv elég, hogy ne helyezze a kiegészítő (nem kívánt) tételek

körül tömb elemeinek HTML. Itt egy példa betét HTML-táblázat egy cikket írt Markdown:

Árleszállítás formázás szintaxis belül nem használják fel blokk-szintű HTML. Például nem tudja használni markdaunovskoe # 42; szöveg kiválasztása # 42; (Cm. Az alábbiakban) a blokkon belül a HTML.

Ellentétben blokk szintű HTML, HTML elemek inline Markdown szintaxis kerül feldolgozásra.

Automatikus kódolás speciális karakterek

A HTML-ben van két karakter, hogy szükség van egy speciális kapcsolat magában: ez <и &. Левая угловая скобка используется как начало тэга; амперсанды применяются для обозначения сущностей (entities). А чтобы использовать эти символы в их буквальном смысле, приходится их самих приводить как сущности, то есть < и - соответственно.

akkor a href attribútum meg kellett kódolni, mint ez:

Ez könnyű elfelejteni ezt a tényt, és mivel ez egy kimeríthetetlen forrása a HTML hibák, még területek, amelyek egyébként használt, kiváló elrendezésű.

Árleszállítás lehetővé teszi, hogy ezeket a karaktereket, amely természetes módon; törődik, hogyan kell kerülni. Ha az & jelet használunk része a HTML-entitás, az változatlan marad; különben Markdown majd kapcsolja be -.

Így annak érdekében, hogy illesszék be a copyright jelet a cikkben, csak írj

és Markdown hagyja úgy, ahogy van. És ha írsz

A Markdown alakítja kód

Hasonlóan, mivel Markdown támogatja inline HTML, akkor relációjelet külön HTML-címkéket a szöveget, Markdown tartalékok változatlan. De ha írsz

A Markdown alakítja a szöveget kód

Azonban a sorok a kódrészletek, és a kód blokkokat Markdown csúcsos zárójel és az és jelet mindig kódolva automatikusan. Ez egyszerűbbé teszi a használatát Markdown ha a szöveg fordítják HTML, és különbözteti meg magát a Markdown HTML nyelvet (ami szörnyen kényelmetlen írt HTML szintaxis, mert a karakterek <или & приходится избегать посредством специального кодирования).

blokk jelölés

Bekezdések és a sortöréseket

Bekezdés írt Markdown meglehetősen egyszerű: egy vagy több sornyi szöveget, elkülönül a környező szöveget egy (vagy több) üres sort. (Egy üres stringet kell tekinteni minden olyan, ami úgy néz ki, üres, egy string, amely nem más, mint szóköz vagy tab tartják üresen.) Normál bekezdések nem lehet beljebb kínálat szóköz vagy tab.

Beszúrni egy látható sortörést (elem
) By Markdown, egyet kell célvonalat két (vagy több) hiányosságok, és csak ezután nyomja meg az

Természetesen, ez több erőfeszítést igényel, mint az egyszerű szabályt, hogy „minden sortörés alakítjuk
és láthatóvá válik”, azonban általában nem alkalmas Markdown. Néhány (lásd alább) funkciók Markdown szintaxis - email-szerű blokk idézet, mnogoabzatsnye lista tételek - sokkal jobb megjelenés, ha a méret „kemény új sort.”

Árleszállítás támogatja a két stílus fejlécek: az aláhúzott és kiemelte a „#” jel. Az aláhúzott fejlécek aláhúzással egyenlő jelek (ha az első szintű fejléc) vagy kötőjelek (ha a második szintű). Itt egy példa:

Ez illeszkedik bármilyen szám hangsúlyozza a karakterek „=” vagy „-”. Rovatok kitöltése „#” jel azt jelenti, egytől hat ilyen karakter egy sorban a sor elejére, karakterek száma megegyezik a szintet a header (elsőtől a hatodik). Itt egy példa:

Árleszállítás elnéző a lusta, és ily módon lehetővé teszi, hogy> előtt az első sorban egy bekezdés, akkor is, ha a „kemény-line fordítás” ez van osztva több sorban is.

Idézetek ágyazhatók (azaz idézetek belül idézetek), azok jelölés használatának további szintjét „>”:

Idézetek tartalmazhat más elemeket Markdown - fejezetek, listák, kódblokkot:

Árleszállítás lehetővé teszi, hogy rendezett és rendezetlen listákat.

Mint egy rendezetlen lista markerek által használt csillagok, vagy a profik, vagy kötőjelet; Ezek a szimbólumok lehetnek erre a célra felcserélhetően használhatók.

Például itt van a példa:

teljesen megegyezik a here:

A számozott listák használják a pont markerek:

Konkrét számokat használunk az elrendezés listán, nincs hatása a termelő Markdaunom végső HTML-kódot. A fenti lista Markdown tesz HTML-kód:

Ha ehelyett írja le egy ilyen lista:

Azonban minden esetben a számozás számozott lista kell kezdeni, bár egy alkotója Markdown utal, hogy további fejlesztés kezdődhet Markdown támogatást számozás kezdő tetszőleges számot.

List markerek általában kezdődik a sor elejére, de lehet, hogy előtte legfeljebb három terek. A marker követnie kell vagy egy teret (egy vagy több), vagy tab karaktert.

Beauty ellátható következő sorokat tagolt listája:

De ha nincs szükség, akkor nem vesztegeti az idejét:

Ha elemeket itt üres sorok választják el, Markdown fog fordulni néhány ilyen elem címkék

a végső HTML-kódot. Például itt a lista:

Meg kell átalakítani, hogy a forma

de mivel ez egy:

Meg kell átalakítani, hogy a forma

Listaelemei tartalmazhat több bekezdést. A második, a harmadik és minden további paragrafus elemet kell ellátni tagolt négy szóköz vagy egy fül karakter:

List jól néz ki, ha minden sor behúzva kínálat. De ha nincs ideje rá, akkor Markdown elég, hogy őket csak az első sora egy bekezdés:

Ha az idézet belsejében egy lista elemet, akkor azt kell biztosítani tagolt elválasztó „>” megelőző idézet:

Ahhoz, hogy kódblokkba belül listaelemet, a kód blokk kellene, hogy egy dupla tagolt, vagyis akár nyolc szóköz vagy két füllel:

Sajnos, egy számozott lista, meg lehet kezdeni a baleset, csak írásban, valahogy így:

(Azaz, más szóval, az írás vonal elején egy szekvencia, amely számokat, pontokat és térben). Annak elkerülése érdekében, ez a hatás, akkor lehet, hogy egy backslash előtt a pont:

Azonban, mint a jelenleg Markdown lehetővé teszi, hogy indítsa el a számozás a lista csak egy, ez a hatás elhanyagolható.

kód blokkokat

Ahhoz, hogy hozzon létre egy kódbiokkjának Markdown, éppen elég, hogy minden sor behúzva blokk, amely négy szóköz vagy tab karaktert. Például itt van a szöveg:

Úgy kell átalakítani Markdaunom következő HTML-kód:

Egy behúzás mértékét (4 szóköz vagy lap jellegű 1) töröltük minden sora kód blokk. Például itt van a szöveg:

Meg kell átalakítani, hogy a forma

A kód blokk folytatódik, amíg, amíg a húr lesz megtalálható nincs behúzva (vagy a szöveg végén).

Bent a kód blokk, és jelet ( „”), vagy kerek zárójelek ( "<» и «>„) Automatikusan átalakítható HTML-entitások (HTML entitások). Ezért könnyen kezelhető Markdown a példákat a nyelvi HTML: helyezze őket eléggé, és tagolt, és Markdown vigyázni fog kódoló és jelet és a szögletes zárójel. Például itt van a példa:

Tart a formáját a következő HTML-kód:

Normál Markdown szintaxis nem kerül feldolgozásra a kód blokkokat. Például csillaggal programkódblokkot csak venni csillag szó. Így könnyen kezelhető Markdown azon, hogy írjak róla a saját szintaktikai rendelkezik szemléltető példákat.

A vízszintes vonal

Ahhoz, hogy hozzon létre egy vízszintes vonalat (a megfelelő HTML-elem


), Elég, hogy három (vagy több), kötőjelet, vagy csillagok, vagy aláhúzás egyetlen sort. Ha úgy tetszik, a kötőjelet vagy csillag lehet elhelyezni terek. Minden sor megegyezik a vízszintes határok:

beépített elemek

hiperhivatkozások

Árleszállítás támogat három stílus design linkeket:

Az első pár stílus arra utal, hogy van még szöveges linkek mellett az URL; a jelölés azt [szögletes zárójelben].

Ebből példa a következő HTML-kód:

Mert linkek a helyi erőforrások (azaz található ugyanazon a szerveren van), akkor a relatív útvonalakat:

opcionális tér elválasztására alkalmazható két pár zárójelben:

Ezután bárhol a dokumentumban, meg kell határozni a referencia jel, amely egy külön sorban a jövő típusok:

Ez a vonal az alábbi elemeket tartalmazza:

  • ID referenciák, szögletes zárójelek (amely megelőzheti egy opcionális padding - egy-három terek).
  • vastagbél,
  • Egy vagy több szóközzel (vagy lapok).
  • URL hivatkozásokat.
  • Egy opcionális cím (eszközleírás) hiperhivatkozásokat, zárt kettős vagy egyszeres idézetek vagy zárójelben.

Három linkek a következő meghatározásokat egyenértékűek a márka:

URL hivatkozásokat lehet (de nem feltétlenül) kell helyezni szögletes idézetek:

Tudod, hogy a cím a következő sorban, és előtte a behúzás a terek (vagy fül); hosszú URL ilyen rekord jobban néz ki:

Ezek a definíciók kapcsolatok felhasználása csak a link létrehozása önmagában feldolgozásakor szövegének Markdown; A végső HTML-kód meghatározása linkek eltávolítják.

Azonosítók kapcsolatok állhatnak betűket, számokat, szóközöket és írásjeleket, de nem érzékenyek. Például, itt van két link:

Árleszállítás lehetővé teszi, hogy implicit címkét hivatkozásokat; Ebben az esetben a címke nem adott, hanem használja a szöveg a hivatkozás, és mint a neve, a második pár szögletes zárójel üres marad. Például, hogy a szó «Google» egy hivatkozásra vezető google.com oldalon, elég ahhoz, hogy írni:

majd határozza meg a hivatkozás:

Mivel a referencia-nevek tartalmazhatnak szóközt, ez a módszer működik, és amikor a hivatkozás szövegét több szóból áll:

És akkor meg egy hivatkozás:

Az ilyen meghatározások kapcsolatokat lehet bárhol elhelyezkedhetnek Markdown dokumentumot. Ha ezeket a végén minden egyes pontját, amelyben használják őket, vagy a végén a teljes dokumentum, például a lábjegyzetek.

Az előnye, hiperhivatkozásokat, mint Lábjegyzetek

Implicit címke hivatkozások, ahelyett, írhat:

Ezen példák mindegyikében az alakítjuk Markdaunom a következő HTML-látvány:

Szemantikus szövegkijelölési

Árleszállítás veszi csillaggal ( „*”) és aláhúzás ( „_”) a jelek szemantikai kijelölt szöveget:

  • Szöveg körül egyetlen „*” és „_”, borítékolás HTML-tag .
  • Szöveg, körülvéve dupla „*” és „_”, borítékolás HTML-tag .

Például itt van a szöveg:

Úgy kell átalakítani, hogy az alábbi HTML-kód:

Az izolált fragmenst, és lehet a közepén a szó:

De ha a „*” jel vagy a „_” körül egy helyet, akkor szerez a szó jelentését.

Ahhoz, hogy egy csillag vagy aláhúzás karakter abban a helyzetben, amelyben ez a szimbólum egyébként felfogható kiemelve a szöveg, meg kell tenni egy backslash előtt csillag jel vagy aláhúzás:

A kódrészletek sorok

Megjelölésére sor fragmentumot, amely a kód, az egyik körül kell vennie annak inverzét aposztróf ( „# 96”;). Ellentétben blokov_koda, kódrészlet segítségével tegye a kódot egy normál bekezdés szövegét. Itt egy példa:

Ez megfelel az alábbi HTML-kód:

Használjuk a fordított aposztróf belül kódot annak szó szoros értelmében, használata párosított backquotes megkomponálhatók kódot fragmens:

HTML-kód lesz:

Fordított aposztróffal környező kódot tartalmazhatnak szóközöket - az egyik hely után a nyitó idézőjel és egy zárás után. Ez lehetővé teszi, hogy a fordított aposztróf (a szó szerinti értelemben vett) elején és (vagy) a végén a kódsor töredék. Íme néhány példa:

HTML-kód a példához lesz:

Belül a kód fragmens vonal összes és jelet és relációjelet alakítjuk formájában a megfelelő HTML-entitások (HTML entitások), amely egyszerűsíti a felvételét példák a HTML nyelvet. Például Markdown alakítja a szöveget itt:

A következő HTML-látvány:

Azt is írja:

és kap a következő HTML-kód:

kép

Más szóval, az alábbi elemeket tartalmazza:

  • A felkiáltójel.
  • A konzolok, amelyek azt jelzik, alternatív kép szöveg (ez lesz az alt attribútumot az elem img).
  • A zárójelek, tartalmazó az URL vagy a relatív útvonal a kép, valamint a (adott esetben) a tartalmát az attribútum neve (elemleírás a kép), zárt kettős vagy egyszeres idézetek.

A fényképek hasonló módon lábjegyzetek vannak írva a következő:

ahol «id» - a neve egy bizonyos kép tag. Címkék képek meghatározása a szintaxis, ez azonos a címkék a linkeket:

Meg kell jegyezni, hogy Markdown nem teszi lehetővé, hogy állítsa be a képméretet (szélesség, magasság); ha egy ilyen feladat fontos, akkor érdemes használni a közös elem HTML nyelvet.

Egyszerűen beszúrásával URL

Árleszállítás és rávenni, hogy a HTML-kódot

alakítjuk ilyen elme:

A használata a fordított perjel

Amint azt már említettük, (backslash jel „\”) lehet használni Markdown előtt speciális karakterek, hogy érzékelhető a literális (nem hivatalos) értéket. Például, ha az egyik meg kell tenni a szöveget egy keretben a csillagok (és nem használja a csillag, mint egy szimbólum a szemantikus kijelölt szöveg), akkor írd a következők szerint:

Itt megtalálja az összes karakter, akinek a Markdown, akkor tesz egy backslash, így vitték szó:

utószó

Ezt a szöveget írták Jelölés használata PHP Markdown Extra.

Kezdetben nem akarja közzétenni az oldalán a szöveget, de egy orosz fordítás hiányzó fordítás idealogii Markdown. Egy másik „pro” volt - fordítás elérhető Garancia 2.

Ügyeljen arra, hogy a szöveg útján elfogadott dőlt, vagy ha ez nem lenne elég, a félkövér szöveg. Az angol, a szó hangsúlyt ügy - vegye figyelembe a kiválasztási dőlt. Az eredeti, kiderül, hogy olyasmi, mint egy játék a szavakkal. # 8617;

Úgy látszik, a fordítás eredetileg a tulajdonos által készített az elhunyt markdown.pp.ru hely, ahonnan másolták az enciklopédiában „hagyomány”, ami rosszul másolt pár hármas ülések. Az ugyanazon a helyszínen, nem adom fel. # 8617;

Keresés az oldalon

Kapcsolódó cikkek