Markdown

Markdown175x175pxФайлын өргөтгөл.md, .markdownGruber, John (8 January 2014). "The Markdown File Extension". The Daring Fireball Company, LLC. Retrieved 27 March 2022. Too late now, I suppose, but the only file extension I would endorse is “.markdown”, for the same reason offered by Hilton Lipschitz: We no longer live in a 8.3 world, so we should be using the most descriptive file extensions. It’s sad that all our operating systems rely on this stupid convention instead of the better creator code or a metadata model, but great that they now support longer file extensions.Интернэт файлын төрөлtext/markdownLeonard, Sean (March 2016). "The text/markdown Media Type". Request for Comments: 7763. Internet Engineering Task Force. Retrieved 27 March 2022. This document registers the text/markdown media type for use with Markdown, a family of plain-text formatting syntaxes that optionally can be converted to formal markup languages such as HTML.Uniform Type Identifier (UTI)net.daringfireball.markdownХөгжүүлэгчидJohn Gruber and Aaron SwartzАнхны хувилбарMarch 9, 2004 (18 years ago) (2004-03-09)Swartz, Aaron (2004-03-19). "Markdown". Aaron Swartz: The Weblog.Gruber, John. "Markdown". Daring Fireball. Archived from the original on 2004-03-11. Retrieved 2022-08-20.Сүүлийн хувилбар1.0.1December 17, 2004 (17 years ago) (2004-12-17)Markdown 1.0.1 readme source code  Форматын төрөлOpen file format"Markdown: License". Daring Fireball. Retrieved 2014-04-25.Extended topandoc, MultiMarkdown, Markdown Extra, CommonMark,Leonard, Sean (March 2016). "Guidance on Markdown:   Design Philosophies, Stability Strategies, and Select Registrations". Request for Comments: 7764. Internet Engineering Task Force. Retrieved 27 March 2022. This document elaborates upon the text/markdown media type for use with Markdown, a family of plain-text formatting syntaxes that optionally can be converted to formal markup languages such as HTML. Background information, local storage strategies, and additional syntax registrations are supplied. RMarkdown"RMarkdown Reference site".Вэб хуудасdaringfireball.net/projects/markdown/
Markdown бол энгийн текст засварлагч ашиглан форматлагдсан текст үүсгэхэд зориулагдсан хөнгөн тэмдэглэгээний хэл юм. Жон Грубер, Аарон Сварц нар 2004 онд Markdown-ыг эх кодын хэлбэрээр уншигчдын сонирхлыг татдаг тэмдэглэгээний хэл болгон бүтээжээ.  Markdown нь блог хөтлөх, шуурхай мессеж бичих, онлайн форум, хамтран ажиллах программ хангамж, баримт бичгийн хуудас, унших файл зэрэгт өргөн хэрэглэгддэг.

Markdown  -ийн анхны хувилбар нь хоёрдмол утгатай байсан бөгөөд хариултгүй асуултуудыг үүсгэсэн нь хэрэгжилтийг санаатай болон санамсаргүй байдлаар эх хувилбараас нь салгахад хүргэсэн. 2014 онд Markdown-ын олон жилийн хувь нэмэр оруулагчид CommonMark -ийг гаргасан бөгөөд энэ нь Markdown-д зориулсан хоёрдмол утгагүй тодорхойлолт, туршилтын багц юм. 

 Түүх 
Markdown нь өмнөх тэмдэглэгээний хэл болох setext (1992 он), Textile (2002 он) болон reStructuredText ( 2002 он) зэрэг цахим шуудан болон usenet нийтлэл дэх энгийн текстийг тэмдэглэхэд зориулагдсан урьд өмнө байсан конвенцуудаас санаа авсан. 

2002 онд Аарон Сварц atx -ийг бүтээж, үүнийг "жинхэнэ бүтэцтэй текст формат" гэж нэрлэсэн. Дараа нь Сварц, Грубер нар 2004 онд   хүмүүст "уншихад хялбар, бичихэд хялбар энгийн текст форматыг ашиглан бичих, сонголтоор  XHTML (эсвэл HTML )."  формат руу хөрвүүлэх боломжтой Markdown хэлийг бүтээхээр хамтран ажилласан. 

Дизайны гол зорилго нь унших боломжтой байх, хэл нь шошго, форматлах заавраар тэмдэглэгдсэн мэт харагдахгүйгээр, [9] Rich Text Format (RTF) гэх мэт "хүнд" тэмдэглэгээний хэлээр форматлагдсан текстээс ялгаатай нь унших боломжтой байх явдал байв. ), HTML, эсвэл бүр викитекст (тус бүр нь тодорхой мөр доторх шошго, форматлах заавартай байдаг нь текстийг уншихад хэцүү болгодог).

Gruber Markdown.pl Perl скриптийг бичсэн бөгөөд энэ нь тэмдэглэсэн текстийн оролтыг хүчинтэй, сайн хэлбэртэй XHTML эсвэл HTML болгон хувиргаж, өнцгийн хаалт ( <, > ) & ) харгалзах тэмдэгтийн нэгжийн лавлагаагаар сольдог. Энэ нь бие даасан скрипт, Blosxom эсвэл Movable Type -д зориулсан залгаас эсвэл BBEdit -д зориулсан текст шүүлтүүрийн үүргийг гүйцэтгэж болно. 

 Өсөлт ба зөрүү 
Markdown-ийн алдар нэр хурдацтай өсөхийн хэрээр олон Markdown хэрэгжүүлэлтүүд гарч ирсэн бөгөөд үүнд ихэвчлэн хүснэгт, зүүлт тайлбар, тодорхойлолтын жагсаалт, Technically HTML description lists. болон HTML блок доторх Markdown зэрэг нэмэлт функцууд шаардлагатай болсон.

Markdown нь зөвхөн албан бус тодорхойлолт  болон HTML рүү хөрвүүлэхэд зориулсан Perl хэрэгжүүлэлтээр тодорхойлогддог байсан тул тэдгээрийн заримынх нь зан байдал лавлагаа хэрэгжүүлэлтээс ялгаатай байв.

Үүний зэрэгцээ албан бус тодорхойлолтод хэд хэдэн ойлгомжгүй байдал анхаарал татсан.  Эдгээр асуудлууд нь Babelmark   зэрэг янз бүрийн хэрэгжүүлэлтийн үр дүнг харьцуулах  зэрэг хэрэгслүүдийг бий болгоход түлхэц өгч, зарим Markdown задлагчийг стандартчилах оролдлого хийсэн. Гэсэн хэдий ч Грубер бүрэн стандартчилал нь алдаа болно гэж маргаж байна: "Өөр өөр сайтууд (мөн хүмүүс) өөр өөр хэрэгцээтэй байдаг. Хэн ч синтакс бүгдийг аз жаргалтай болгохгүй." 

Грубер Markdown-д нуман хаалт ашиглахаас зайлсхийж, тэдгээрийг хэрэгжүүлэхэд зориулагдсан өргөтгөлүүдэд албан бусаар нөөцөлсөн. 

 Стандартчилал 

CommonMark175x175pxФайлын өргөтгөл.md, .markdownИнтернэт файлын төрөлtext/markdownUniform Type Identifier (UTI)public.plain-textХөгжүүлэгчидJohn MacForlane open sourceАнхны хувилбаресдүгээр сарын 25, 2014  (2004-03-09)Сүүлийн хувилбарv0.30 зургаан сарын 19 2021Форматын төрөлOpen file formatExtended toGitHub Flavored MarkdownВэб хуудасspec.commonmark.org
2012 оноос эхлэн Жефф Атвуд, Жон МакФарлейн нарын хэсэг хүмүүс Атвудын стандартчиллын хүчин чармайлт гэж тодорхойлсон зүйлийг эхлүүлсэн.  Олон нийтийн вэбсайт нь одоо "зохиогчид болон хөгжүүлэгчид, түүнчлэн Markdown-ийн төрөл бүрийн хэрэгжилтийг хэрэгжүүлэгчдэд зориулсан төрөл бүрийн хэрэгсэл, нөөцийг баримтжуулах" зорилготой.  2014 оны 9-р сард Грубер энэхүү хүчин чармайлтын нэрээр "Markdown"-ыг ашиглахыг эсэргүүцэж, түүнийг CommonMark болгон өөрчилсөн.   CommonMark.org нь тодорхойлолт, лавлагааны хэрэгжилт, туршилтын багц болон "2019 онд эцэслэн боловсруулсан 1.0 үзүүлэлт болон туршилтын багцыг зарлахаар төлөвлөж байна" гэсэн хэд хэдэн хувилбарыг нийтэлсэн.  Гол асуудлууд шийдэгдээгүй хэвээр байгаа тул үүнээс хойш 1.0 техникийн хувилбар гараагүй байна.  Гэсэн хэдий ч дараах вэбсайтууд болон төслүүд CommonMark-ийг нэвтрүүлсэн: Discourse, GitHub, GitLab, Reddit, Qt, Stack Exchange ( Stack Overflow ) болон Swift .

2016 оны 3-р сард холбогдох мэдээллийн хоёр Интернэт RFC нийтлэгдсэн:

   introduced MIME type text/markdown.
   discussed and registered the variants MultiMarkdown, GitHub Flavored Markdown (GFM), Pandoc, and Markdown Extra among others.

 Хувилбарууд 
GitHub,  Bitbucket, Reddit,  Diaspora, Stack Exchange,  OpenStreetMap болон SourceForge  зэрэг вэб сайтууд нь Markdown-ын хувилбаруудыг ашиглан хэрэглэгчдийн хоорондын хэлэлцүүлгийг хөнгөвчилдөг. Markdown нь Microsoft Teams чат  болон Discord мессеж зэрэг олон төрлийн програм, үйлчилгээнд дэмжигддэг. 

Хэрэгжилтээс хамааран үндсэн доторлогоотой HTML хаягуудыг дэмжиж болно.  Налуу текстийг _underscores_ ба/эсвэл *single-asterisks* хийж болно. 

 GitHub Flavored Markdown 
GitHub нь Markdown-ын өөрийн хувилбарыг 2009 оноос хойш ашиглаж ирсэн бөгөөд  жагсаалтын элементүүдийн доторх хүснэгт, блокийн агуулгыг үүрлэх, түүнчлэн GitHub-д хамаарах функцууд, тухайлбал амлалтуудыг автоматаар холбох, асуудал, хэрэглэгчийн нэр гэх мэт. 2017 онд GitHub нь CommonMark дээр суурилсан GitHub Flavored Markdown (GFM)-ийн албан ёсны тодорхойлолтыг гаргасан.  Энэ нь GFM-ийн өргөтгөл болгон нэмдэг хүснэгт, зураас, автомат холбоос, даалгаврын жагсаалтаас бусад тохиолдолд CommonMark-ын хатуу дээд багц юм.  GitHub мөн сайтууддаа ашигласан задлан шинжлэгчийг өөрчилсөн тул зарим баримт бичгийг өөрчлөх шаардлагатай болсон. Жишээлбэл, GFM одоо гарчгийг үүсгэдэг хэш тэмдгийг гарчгийн текстээс зай тэмдэгтээр тусгаарлахыг шаарддаг.

 Markdown Extra 
Markdown Extra нь PHP (анх), Python болон Ruby дээр хэрэгжсэн Markdown дээр суурилсан хөнгөн хэлбэрийн тэмдэглэгээний хэл юм.  Энэ нь энгийн Markdown синтакс дээр байхгүй функцуудыг нэмдэг. Markdown Extra нь Drupal  болон TYPO3 зэрэг контентын удирдлагын зарим системд дэмжигддэг. 

Markdown Extra нь Markdown-д дараах боломжуудыг нэмдэг:

 HTML блок доторх тэмдэглэгээ
 ID/class шинж чанартай элементүүд
 Кодын олон мөрийг хамарсан "хашаалагдсан кодын блокууд"
 Хүснэгт 
 Тодорхойлолтын жагсаалтууд
 Зүүлт тайлбар
 Товчлол

 LiaScript 
LiaScript  нь интерактив боловсролын контент бүтээхэд зориулагдсан Markdown хувилбар юм. Энэ нь Elm болон Typescript дээр хөгжүүлэгдсэн бөгөөд дараах шинж чанаруудыг тодорхойлохын тулд нэмэлт синтаксийн элементүүдийг нэмдэг:

 Анимацууд
 Автомат ярианы гаралт
 Математикийн томьёо ( KaTeX ашиглан)
 ASCII урлагийн диаграммууд
 Төрөл бүрийн асуулт хариулт, санал асуулга
 JavaScript нь үндсэндээ дэмжигддэг бөгөөд янз бүрийн элементүүдэд хавсаргах боломжтой бөгөөд ингэснээр кодын хэсгүүдийг гүйцэтгэх, засварлах боломжтой болгодог.

 Жишээ 
Markdown синтакс ашиглан текст Markdown нд харгалзах HTML Текст хөтөч дээр харагдах байдал Heading
=======

Sub-heading
-----------

# Alternative heading #

Paragraphs are separated 
by a blank line.

Two spaces at the end of a line 
produce a line break.<h1>Heading</h1>

<h2>Sub-heading</h2>

<h1>Alternative heading</h1>

<p>Paragraphs are separated
by a blank line.</p>

<p>Two spaces at the end of a line<br>
produce a line break.</p>Heading Sub-heading Alternative heading  Paragraphs are separated by a blank line.

Two spaces at the end of a line

produce a line break.Text attributes _italic_, **bold**, `monospace`.

Хэвтээ дүрэм:

---Текстийн шинж чанарууд налуу, тод, monospace .

Хэвтээ дүрэм: Дугаарлагдсан жагсаалтын дотор байрлуулсан сумны жагсаалт:

 1. жимс жимсгэнэ
   * алим
   * банан
 2. хүнсний ногоо
   - лууван
   - брокколи
 <p>Дугаарлагдсан жагсаалтын дотор байрлуулсан сумны жагсаалт:
</p>

<ol>
 <li>жимс жимсгэнэ<ul>
   <li>алим</li>
   <li>банан</li>
 </ul></li>
 <li>хүнсний ногоо<ul>
   <li>лууван</li>
   <li>брокколи</li>
 </ul></li>
</ol>Дугаарлагдсан жагсаалтын дотор байрлуулсан сумны жагсаалт:

 жимс жимсгэнэ
 алим
 банан
 хүнсний ногоо
 лууван
 брокколи A [link](http://example.com).

![Image](Icon-pictures.png "icon")

> Markdown uses email-style
characters for blockquoting.
>
> Олон догол мөрийг тус тусад нь оруулах шаардлагатай.

Ихэнх inline <abbr title="Hypertext Markup Language">HTML</abbr> хаягуудыг дэмждэг.Холбоос .
link=|alt=Image|дүрс Markdown нь иш татахдаа имэйл маягийн тэмдэгтүүдийг ашигладаг.

 Олон догол мөрийг тус тусад нь оруулах шаардлагатай. Ихэнх inline HTML хаягуудыг дэмждэг.

 Хөгжүүлэлт 
Markdown-ийн хөгжүүлэлтэд арав гаруй програмчлалын хэлийг ашиглах боломжтой; Үүнээс гадна олон платформууд болон фреймворкууд Markdown-ыг дэмждэг.  Жишээлбэл, Markdown блог хөтлөх томоохон платформ бүрт байдаг. 

Markdown нь хамгийн бага тэмдэглэгээний хэл бөгөөд ердийн текст засварлагчаар уншиж, засварладаг боловч бүх томоохон платформд ашиглах боломжтой загвар бүхий файлуудыг урьдчилан харах тусгайлан боловсруулсан редакторууд байдаг. Олон ерөнхий зориулалтын текст болон код засварлагчид Markdown-д зориулсан синтакс тодотгох плагинтай эсвэл нэмэлтээр татаж авах боломжтой байдаг. Засварлагч нар хажуугийн урьдчилан харах цонхыг харуулах эсвэл кодыг WYSIWYG маягаар шууд гаргаж болно.

 JotterPad : Markdown дэмждэг онлайн WYSIWYG засварлагч 
 Doxygen : Markdown-ийг нэмэлт функцээр дэмждэг эх кодын баримтжуулалт үүсгэгч 
 RStudio : R -д зориулсан IDE . Энэ нь sundown  гэж нэрлэгддэг тэмдэглэгээний хувилбарт зориулсан C++ боодлын функцээр хангадаг.
 GitHub Flavored Markdown (GFM) нь үгийн доогуур зураасыг үл тоомсорлож, синтакс тодотгол, ажлын жагсаалт,  болон хүснэгт  нэмдэг.
 RMarkdown 
 Nextcloud Notes : Nextcloud платформ дээр тэмдэглэл хөтлөх үндсэн програм нь Markdown  ашиглан форматлахыг дэмждэг.
 Joplin : тэмдэглэгээний форматыг дэмждэг тэмдэглэл хөтлөх програм 
 Simplenote 
 Obsidian.md 

 Ном зүй 
Ангилал:Pages with unreviewed translations

 Гадаад холбоосууд 
https://daringfireball.net/projects/markdown/  for original John Gruber markup