MD on tavallinen Markdownin laajennus, pelkkä teksti, johon on merkitty tunnisteiden sijaan yksinkertainen välimerkki.
Yleisiä käyttötarkoituksia
File storage and sharing
Data exchange between applications
Content distribution
MD Usein kysytyt kysymykset konversioista
Mikä on MD-tiedosto?
+
Markdown is a lightweight markup language with plain text formatting syntax. It is widely used for README files, documentation, and technical writing. Files typically have .md or .markdown extensions.
Mitä katoaa, kun asiakirjasta tulee MD?
+
Kaikki paitsi sanat. MD sisältää merkkejä ja rivikatkoksia, joten fontit, kokot, värit, taulut, kuvat ja alaviitteet katoavat kaikki matkalla sisään. Juuri siksi sitä käytetään: se on muoto, jota mikään ei voi tulkita väärin, se avautuu mihin tahansa koskaan rakennettuun koneeseen, ja se on oikea kohde, kun teksti on tärkeintä ja esitys ei. Markdownilla ei ole yhtenäistä standardia, joten taulukot, alaviitteet ja sulautettu HTML käyttäytyvät eri tavalla CommonMark-, GFM- ja kaiken muun välillä.
Miksi MD-konfiguraatiossani näkyy outoja symboleja, joissa korostusten pitäisi olla?
+
Koska tekstitiedosto ei tallenna, mitä koodaus sitä käyttää. Tavut ovat yksiselitteisiä, niiden tulkinta on arvaus, ja UTF-8:na kirjoitettu tiedosto, joka luetaan perinteiseksi yksitavuiseksi koodaukseksi, muuttaa jokaisen korostuneen kirjaimen symbolipariksi. Muuntaminen muotoon, joka tallentaa koodauksensa, korjaa sen pysyvästi, mikäli muunnelma kerrotaan, mistä koodauksesta lukea.
Miten rivin MD katkeamisessa ja välityksessä käy?
+
Ne ovat ainoa tiedostojen rakenne, joten ne otetaan kirjaimellisesti. Kovan linjan tauko pitää linjan taukona sen sijaan, että siitä tulisi kappale, joka virtaa uudelleen, ja välilyönneistä tehdyt sarakkeet muodostavat vain yksiavarutetun kirjasinkirjaimen. Sanaprosessoriksi muuntaminen tuottaa siis asiakirjan, joka näyttää tekstitiedostolta eikä kirjasinsarjalta – mikä on rehellistä, ja miksi todellista ulkoasua on sovellettava jälkikäteen.
Onko MD korjattu sivuja?
+
Ei – sisältöä virtaa, ja sivut näkyvät vain, kun jokin päättää sivun koosta. Muuta kirjasinta, marginaalia tai näyttöä ja sivun numerointi muuttuu sen myötä. Siksi sivuviite MD on epäluotettava, ja siksi sivunumeroiden muuttaminen kiinteäksi kaavaksi merkitsee jotain.
Miksi MD on niin paljon pienempi kuin samat sanat asiakirjassa?
+
Koska siinä ei ole muuta. Sananjalostajatiedostossa on tyylejä, fontteja, versiohistoriaa, tiivistettyä pakettirakennetta ja usein myös kuvia; tekstitiedostossa on hahmot ja rivit katkeavat ja pysähtyvät. Kirjanmittainen käsikirjoitus on muutama sata kilotavu. Sekin on syy siihen, että se selviää – sinun ja sanojen välillä ei ole versiota, renderaattoria eikä myyjää. Markdown on dokumentoinnin, README-tiedostojen, staattisten sivustojen generaattoreiden ja muistiinpanojen sarjojen kieli, ja se on täysin eri asia.
Voinko jatkaa editointia muutettuani MD?
+
Se riippuu täysin kohteesta. Muuntaminen toiseen muokattavaan asiakirjaformaattiin pitää rakenteen – tyylit, otsikot, taulukot – normaalisti. Sivulle tai kuvaformaattiin muuntaminen tuottaa jotain luettavaa kirjoittamisen sijaan, ja sieltä palaaminen tarkoittaa toista muunnosta, joka rekonstruoi rakenteen eikä palauta sitä. Pidä MD työkopiona.
Tulkataanko tai otetaanko MD-muodossa olevat merkkien muotoilu kirjaimellisesti?
+
Se on täysin tavoite. Kevyttä merkintää ymmärtävään muotoon muuntaminen muuttaa hasheet, tähdet ja välimerkit todellisiksi otsikoiksi, painotuksiksi ja listoiksi; muuntaminen muotoon, joka ei jätä niitä sivulle välimerkkinä. On syytä olla selkeä siitä, mitä haluat, koska nämä kaksi tulosta näyttävät hyvin erilaisilta, eikä kumpikaan ole väärässä omilla ehdoillaan.
Kuka hallitsee MD-muotoa?
+
Ei kukaan, ja se on asian ydin. Spesifikaatio on julkinen, kuka tahansa voi toteuttaa sen kysymättä tai maksamatta, eikä yksikään yritys voi muuttaa ehtoja myöhemmin – siksi arkistot, standardielimet ja julkiset laitokset määrittelevät tämänkaltaiset muodot kaikkea varten, joka vielä on avattava 20 vuoden kuluttua. Kauppa ei ole yhteensopivaa, mikä on erinomaista; se on, että ei ole myyjää, jolle soittaa, kun jokin työkalu toteuttaa speciä huonosti. MD on Markdown, John Gruberin 2004 selkeä tekstisyntaksi, jolla kirjoitetaan rakenteellisia asiakirjoja, jotka pysyvät luettavissa lähteenä.
Voinko muuttaa koko kansion MD tiedostoista yhdellä kertaa?
+
Tilillä kyllä – pudota ne yhteen ja heitä jonotetaan yhtenä työnä eikä yksi kerrallaan, ja samat asetukset on sovellettu eri erissä, ja tulokset palautuivat yhteen. Ilmaiset muunnelmat kulkevat yhden tiedoston kerrallaan (sulatustyökalut vievät kaksi); maksullinen suunnitelma avaa erän käsittelyn ja suuremman per-files -rajan, mikä tekee kokonaisen arkiston muuttamisesta käytännöllisen.
Mitä tapahtuu MD- tiedostolleni muuntamisen jälkeen?
+
Se poistetaan. Lataus ja tulos on käännetty palvelimelle vain niin kauan kuin työ vaatii niitä ja poistetaan automaattisesti. Siirto kulkee HTTPS:n yli molempiin suuntiin. Kukaan ei lue sisältöä, mitään ei indeksoida eikä mitään välitetä kenellekään muulle. Jos et halua odottaa automaattista hakua, työn sulkeminen poistaa tiedostot välittömästi.
Kuinka kauan MD-äänen muuntaminen kestää?
+
Yleensä sekunteja. Pienet tiedostot ovat käytännössä hetkessä, ja tosiaikaa vievät tapaukset ovat todellisia: pitkä nauhoitus, joka on koodattava uudelleen kehyksellä, hahmotunnistuksen läpivalaisu tai erittäin suuri erä. Jos muuntaminen vain uudelleenkirjoittaa tai uudelleenpakkaa olemassa olevan datan, se pysyy nopeana riippumatta siitä, kuinka suuri tiedosto on, koska mitään ei pureta.
