Из Википедии, бесплатной энциклопедии
Перейти к навигации Перейти к поиску

Легкий язык разметки ( LML ), также называемый простой или гуманного язык разметки , это язык разметки , с помощью простого, ненавязчивого синтаксиса . Он разработан таким образом, чтобы его было легко писать с помощью любого обычного текстового редактора и легко читать в исходном виде. Облегченные языки разметки используются в приложениях, где может потребоваться прочитать необработанный документ, а также окончательный визуализированный вывод.

Например, человек, загружающий библиотеку программного обеспечения, может предпочесть читать документацию в текстовом редакторе, а не в веб-браузере. Другое применение таких языков - обеспечение ввода данных в веб-публикациях , таких как веб-журналы и вики , где интерфейс ввода представляет собой простое текстовое поле . Затем серверное программное обеспечение преобразует входные данные в общий язык разметки документов, такой как HTML .

История [ править ]

Первоначально облегченные языки разметки использовались только для текстовых дисплеев, которые не могли отображать символы курсивом или жирным шрифтом , поэтому пришлось разработать неформальные методы передачи этой информации. Этот выбор форматирования был естественным образом перенесен на сообщения электронной почты в виде простого текста. Консольные браузеры также могут прибегать к аналогичным соглашениям об отображении.

В 1986 году международный стандарт SGML предоставил средства для определения и анализа облегченных языков разметки с использованием грамматик и импликации тегов. W3C XML 1998 года - это профиль SGML, в котором эти возможности отсутствуют. Однако определение типа документа SGML (DTD) для любого из перечисленных ниже языков неизвестно.

Типы [ править ]

Легкие языки разметки можно разделить на категории по типам тегов. Как и HTML ( ), в некоторых языках используются именованные элементы, которые имеют общий формат для начальных и конечных тегов (например, BBCode ), тогда как правильные облегченные языки разметки ограничены только знаками препинания ASCII и другими небуквенными символами для тегов, но некоторые также смешайте оба стиля (например, Textile ) или разрешите встроенный HTML (например, Markdown ), возможно, расширенный пользовательскими элементами (например, MediaWiki ).<b>bold</b> [b]bold[/b] bq. <ref>source</ref>

Большинство языков различают разметку для строк или блоков и для более коротких отрезков текста, но некоторые поддерживают только встроенную разметку.

Некоторые языки разметки предназначены для определенной цели, например, для документирования компьютерного кода (например, POD , RD ) или для преобразования в определенный выходной формат (обычно HTML) и ничего больше, другие более общие в применении. Сюда входит, ориентированы ли они на текстовое представление или на сериализацию данных. [ требуется разъяснение ]

Презентационные ориентированные языки включают AsciiDoc , АТХ , BBCode, креольской , Crossmark, Epytext , Haml , JsonML , MakeDoc , Markdown, Org-режим , POD, Rest , RD, Setext , Sisu , SPIP , Xupl , TExy! , Текстиль, txt2tags , UDO и Wikitext .

Языки, ориентированные на сериализацию данных, включают Curl (гомоиконный, но также читает JSON; каждый объект сериализует), JSON и YAML .

Сравнение языковых характеристик [ править ]

Сравнение языковых функций
ЯзыкИнструмент экспорта HTMLИнструмент импорта HTMLСтолыЗаголовки ссылокclass атрибутid атрибутДата выхода
AsciiDocдададададада2002-11-25 [1]
BBCodeНетНетдаНетНетНет1998 г.
КреольскийНетНетдаНетНетНет2007-07-04 [2]
Gemtextда?НетдаНетНет2020 г.
Уценка со вкусом GitHubдаНетдадаНетНет2011-04-28 +
Обозначение форматирования JiraдаНетдадаНетНет2002+ [3]
MarkdownдадаНетдаДа нетДа нет2004-03-19 [4] [5]
Markdown ExtraдадаДа [6]дадада2013-04-11 [7]
MediaWikiдададададада2002 [8]
MultiMarkdownдаНетдадаНетНет2009-07-13
Орг-режимдаДа [9]дададада2003 [10]
PmWikiДа [11]дадададада2002-01
PODда?Нетда??1994 г.
reStructuredTextдаДа [9]дададаавто2002-04-02 [12]
СлабинаНетНетНетдаНетНет2013+ [13] [14]
TiddlyWikiдаНетдададаНет2004-09 [15]
ТекстильдаНетдададада2002-12-26 [16]
Texyдададададада2004 [17]
txt2tagsдаДа [18]Да [19]даДа нетДа нет2001-07-26 [20]
WhatsAppНетНетНетНетНетНет2016-03-16 [21]

Собственный синтаксис Markdown не поддерживает атрибуты класса или атрибуты id; однако, поскольку Markdown поддерживает включение собственного HTML-кода, эти функции могут быть реализованы с использованием прямого HTML. (Некоторые расширения могут поддерживать эти функции.)

Собственный синтаксис txt2tags не поддерживает атрибуты класса или атрибуты id; однако, поскольку txt2tags поддерживает включение собственного кода HTML в области с тегами, эти функции могут быть реализованы с использованием прямого HTML при сохранении в целевой HTML. [22]

Сравнение возможностей реализации [ править ]

Сравнение реализаций, особенно форматов вывода
ЯзыкРеализацииX HTMLCon / La TeXPDFDocBookODFEPUBДОК (X)LMLsДругойЛицензия
AsciiDocPython , Ruby , JavaScript , JavaXHTMLЛатексPDFDocBookODFEPUBНет -Страница руководства и т. Д.GNU GPL, MIT
BBCodePerl , PHP , C # , Python , Ruby(X) HTMLНетНетНетНетНетНет--Всеобщее достояние
КреольскийPHP , Python , Ruby , JavaScript [23]Зависит от реализацииCC_BY-SA 1.0
Уценка со вкусом GitHubHaskell ( Pandoc )HTMLLaTeX, ConTeXtPDFDocBookODFEPUBDOCAsciiDoc , reSTOPMLGPL
Java , [24] JavaScript , [25] [26] [27] PHP , [28] [29] Python , [30] Ruby [31]HTML [25] [26] [27] [29] [30]НетНетНетНетНетНет--Проприетарный
MarkdownPerl (изначально), C , [32] [33] Python , [34] JavaScript , Haskell , [9] Ruby , [35] C # , Java , PHPHTMLLaTeX, ConTeXtPDFDocBookODFEPUBRTFMediaWiki , reSTСтраница руководства , S5 и т. Д.BSD-стиль и GPL (оба)
Markdown ExtraPHP (изначально), Python , RubyXHTMLНетНетНетНетНетНет--BSD-стиль и GPL (оба)
MediaWikiPerl , PHP , Haskell , PythonXHTMLНетНетНетНетНетНет--GNU GPL
MultiMarkdownC , Perl(X) HTMLЛатексPDFНетODFНетDOC, RTF-OPMLGPL , MIT
Орг-режимEmacs Lisp , Ruby (только парсер), Perl , OCamlXHTMLЛатексPDFDocBookODFEPUB [36]DOCX [36]MarkdownTXT , XOXO , iCalendar , Texinfo , man , contrib: groff , s5 , deck.js, разметка Confluence Wiki, [37] TaskJuggler , RSS , FreeMindGPL
PmWikiPHPXHTML 1.0 переходный, HTML5НетДополнения для экспорта PDFНетНетДополнение для экспорта EPUBНет--GNU GPL
PODPerl(X) HTML, XMLЛатексPDFDocBookНетНетRTF-Страница руководства , простой текстХудожественная лицензия , лицензия Perl
reStructuredTextPython , [38] [39] Haskell (Pandoc) , Java ,HTML, XMLЛатексPDFDocBookODFEPUBDOC-человек , S5 , Devhelp , QT Help , CHM , JSONВсеобщее достояние
ТекстильPHP , JavaScript , Java , Perl , Python , Ruby , ASP , C # , HaskellXHTMLНетНетНетНетНетНет--Текстильная лицензия
Текси!PHP , C #(X) HTMLНетНетНетНетНетНет--Лицензия GNU GPL v2
txt2tagsPython , [40] PHP [41](X) HTML, SGMLЛатексPDFDocBookODFEPUBDOCCreole , AsciiDoc , MediaWiki , MoinMoin , PmWiki , DokuWiki , Google Code Wikiroff , человек , MagicPoint , Lout , PageMaker , ASCII Art , TXTGPL

Сравнение синтаксиса облегченного языка разметки [ править ]

Встроенный синтаксис диапазона [ править ]

Хотя обычно документируется выделение текста курсивом и полужирным шрифтом, большинство облегченных процессоров разметки выводят семантические элементы HTML emи strongвместо них. Моноширинный текст может иметь семантические codeили презентационные ttэлементы. Некоторые языки делают различие, например Textile, или позволяют пользователю легко настраивать вывод, например Texy.

LML иногда отличаются для разметки из нескольких слов, где некоторые требуют, чтобы символы разметки заменяли пробелы между словами ( инфикс ). В некоторых языках в качестве префикса и суффикса требуется один символ, в других - удвоенные или даже утроенные или поддерживаются оба символа с немного другим значением, например, с разными уровнями акцента.

Сравнение синтаксиса форматирования текста
Вывод HTML<strong>strongly emphasized</strong><em>emphasized text</em><code>code</code>семантический
<b>bold text</b><i>italic text</i><tt>monospace text</tt>презентационный
AsciiDoc*bold text*'italic text'+monospace text+Может удваивать операторы для применения форматирования там, где нет границы слова (например, **b**old t**ex**tдает b old t ex t).
_italic text_`monospace text`
ATX*bold text*_italic text_|monospace text|стиль электронной почты
BBCode[b]bold text[/b][i]italic text[/i][code]monospace text[/code]Форматирование работает через разрывы строк.
Креольский**bold text**//italic text//{{{monospace text}}}Тройные фигурные скобки предназначены для новики, которая может быть моноширинной.
GemtextНет данныхНет данных```alt text
monospace text
```		Текст, следующий сразу за первыми тремя обратными кавычками, является альтернативным текстом.
Обозначение форматирования Jira*bold text*_italic text_{{monospace text}}
Уценка [42]**bold text***italic text*`monospace text`семантические HTML-теги
__bold text___italic text_
MediaWiki'''bold text'''''italic text''<code>monospace text</code>в основном прибегает к встроенному HTML
Орг-режим*bold text*/italic text/=code=
~verbatim~
PmWiki'''bold text'''''italic text''@@monospace text@@
отдых**bold text***italic text*``monospace text``
Сетекст**bold text**~italic text~Нет данных
Текстиль [43]*strong*_emphasis_@monospace text@семантические HTML-теги
**bold text**__italic text__презентационные HTML-теги
Текси!**bold text***italic text*`monospace text`семантические HTML-теги по умолчанию, дополнительная поддержка презентационных тегов
//italic text//
TiddlyWiki''bold text''//italic text//`monospace text`
``monospace text``
txt2tags**bold text**//italic text//``monospace text``
PODB<bold text>I<italic text>C<monospace text>Текст с отступом также отображается как моноширинный код.
Слабина*bold text*_italic text_`monospace text````block of monospaced text```
WhatsApp*bold text*_italic text_```monospace text```

Gemtext не имеет встроенного форматирования, моноширинный текст (известный в сообществе Gemini форматированный текст) должен иметь начало и закрытие ```на отдельных строках.

Синтаксис акцента [ править ]

В HTML текст выделяется типами элементов <em>и <strong>, тогда как <i>и <b>традиционно выделяют текст курсивом или жирным шрифтом соответственно.

Microsoft Word и Outlook и, соответственно, другие текстовые процессоры и почтовые клиенты, которые стремятся к тому, чтобы пользовательский интерфейс был похожим, поддерживают базовое соглашение об использовании звездочек для жирного шрифта и подчеркивания для курсива. Пока Word удаляет символы, Outlook сохраняет их.

Курсив или нормальный курсив
КодAsciiDocATXКреольскийJiraMarkdownMediaWikiОрг-режимPmWikiотдыхСетекстСлабинаТекстильТекси!TiddlyWikitxt2tagsWhatsApp
*italic*НетНетНетНетдаНетНетНетдаНетНетНетдаНетНетНет
**italic**НетНетНетНетНетНетНетНетНетНетНетНетНетНетНетНет
_italic_дадаНетдадаНетНетНетНетНетдадаНетНетНетда
__italic__даНетНетНетНетНетНетНетНетНетНетдаНетНетНетНет
'italic'даНетНетНетНетНетНетНетНетНетНетНетНетНетНетНет
''italic''даНетНетНетНетдаНетдаНетНетНетНетНетНетНетНет
/italic/НетНетНетНетНетНетдаНетНетНетНетНетНетНетНетНет
//italic//НетНетдаНетНетНетНетНетНетНетНетНетдададаНет
~italic~НетНетНетНетНетНетНетНетНетдаНетНетНетНетНетНет
Смелое лицо или сильный акцент
КодAsciiDocATXКреольскийJiraMarkdownMediaWikiОрг-режимPmWikiотдыхСетекстСлабинаТекстильТекси!TiddlyWikitxt2tagsWhatsApp
*bold*дадаНетдаНетНетдаНетНетНетдадаНетНетНетда
**bold**даНетдаНетдаНетНетНетдадаНетдадаНетдаНет
__bold__НетНетНетНетдаНетНетНетНетНетНетНетНетНетНетНет
''bold''НетНетНетНетНетНетНетНетНетНетНетНетНетдаНетНет
'''bold'''НетНетНетНетНетдаНетдаНетНетНетНетНетНетНетНет

Редакционный синтаксис [ править ]

В HTML, удалены или удалены , и вставленный текст размечен с <del>и <ins>элементных типов, соответственно. Тем не менее, устаревшие типы элементов <s>или <strike>и <u>по-прежнему доступны для зачеркнутых и подчеркнутых участков текста.

Подчеркнутый или вставленный текст
КодJiraMarkdownОрг-режимСетекстTiddlyWikitxt2tags
_underline_НетНеобязательныйдадаНетНет
__underline__НетНеобязательныйНетНетдада
+underline+даНетНетНетНетНет

AsciiDoc, ATX, Creole, MediaWiki, PmWiki, reST, Slack, Textile, Texy! и WhatsApp не поддерживают специальную разметку для подчеркивания текста.

Зачеркнутый или удаленный текст
КодJiraMarkdownОрг-режимСлабинаTiddlyWikitxt2tagsWhatsApp
~stricken~НетНетНетдаНетНетда
~~stricken~~НетGFMНетНетдаНетНет
+stricken+НетНетдаНетНетНетНет
-stricken-даНетНетНетНетНетНет
--stricken--НетНетНетНетНетдаНет

AsciiDoc, ATX, Creole, MediaWiki, PmWiki, reST, Setext, Textile и Texy! не поддерживают специальную разметку для зачеркивания текста.

Синтаксис программирования [ править ]

Цитируемый компьютерный код традиционно представлен шрифтами, подобными пишущей машинке, где каждый символ занимает одинаковую фиксированную ширину. HTML предлагает семантические <code>и устаревшие <tt>типы презентационных элементов для этой задачи.

Моноширинный шрифт, текст телетайпа или код
КодAsciiDocATXКреольскийGemtextJiraMarkdownОрг-режимPmWikiотдыхСлабинаТекстильТекси!TiddlyWikitxt2tagsWhatsApp
@code@НетНетНетНетНетНетНетНетНетНетдаНетНетНетНет
@@code@@НетНетНетНетНетНетНетдаНетНетНетНетНетНетНет
`code`даНетНетНетНетдаНетНетНетдаНетдадаНетНет
``code``даНетНетНетНетдаНетНетдаНетНетНетдадаНет
```code```НетНетНетдаНетдаНетНетНетДа нетНетНетдаНетда
=code=НетНетНетНетНетНетдаНетНетНетНетНетНетНетНет
~code~НетНетНетНетНетНетдаНетНетНетНетНетНетНетНет
+code+даНетНетНетНетНетНетНетНетНетНетНетНетНетНет
++code++даНетНетНетНетНетНетНетНетНетНетНетНетНетНет
{{code}}НетНетНетНетдаНетНетНетНетНетНетНетНетНетНет
{{{code}}}НетНетдаНетНетНетНетНетНетНетНетНетНетНетНет
|code|НетдаНетНетНетНетНетНетНетНетНетНетНетНетНет

Mediawiki, Setext и Gemtext не предоставляют облегченную разметку для встроенных участков кода.

Синтаксис заголовка [ править ]

Заголовки обычно доступны на шести уровнях, но верхний часто зарезервирован, чтобы содержать то же самое, что и заголовок документа, который может быть установлен извне. В некоторой документации уровни могут быть связаны с типами подразделений, например, часть, глава, раздел, статья или абзац.

Большинство LMLs следует один из двух стилей для заголовков, либо Setext -как подчеркивание или АТЙ -как [44] маркеры линии, или они поддерживают оба.

Подчеркнутые заголовки [ править ]

Заголовок уровня 1===============Заголовок уровня 2---------------Заголовок уровня 3~~~~~~~~~~~~~~~

В первом стиле используются подчеркивания, т. Е. Повторяющиеся символы (например =, знак равенства , дефис -или тильда ~, обычно не менее двух или четырех раз) в строке под текстом заголовка.

Подчеркнутые уровни заголовков
Символы:=-~*#+^_:"'`.мин
Markdown12НетНетНетНетНетНетНетНетНетНетНет1
Сетекст12НетНетНетНетНетНетНетНетНетНетНет?
AsciiDoc123НетНетНетНетНетНетНетНетНетНет2
Текси!34Нет21НетНетНетНетНетНетНетНет3
reStructuredTextдададададададададададададаширина заголовка

RST определяет уровни заголовков динамически, что, с одной стороны, делает создание более индивидуальным, а с другой - усложняет слияние из внешних источников.

Заголовки с префиксом [ править ]

# Заголовок уровня 1## Заголовок 2 уровня ##### Заголовок 3-го уровня ###

Второй стиль основан на повторяющихся маркерах (например, хэш #, равно =или звездочка *) в начале самого заголовка, где количество повторений указывает (иногда обратный) уровень заголовка. Большинство языков также поддерживают дублирование маркеров в конце строки, но в то время как некоторые делают их обязательными, другие даже не ожидают совпадения их номеров.

Заголовки с префиксом (и суффиксом) строк
Характер:=#*!+СуффиксУровниОтступ
AsciiDocдаНетНетНетНетНеобязательный1–6Нет
ATXНетдаНетНетНетНетнеограниченный?
КреольскийдаНетНетНетНетНеобязательный1–6Нет
GemtextНетдаНетНетНет?1–3Нет
MediaWikiдаНетНетНетНетда1–6Нет
TiddlyWikiНетНетНетдаНетНет1–6Нет
txt2tagsдаНетНетНетдада1–6Нет
MarkdownНетдаНетНетНетНеобязательный1–6Нет
Текси!дадаНетНетНетНеобязательный6–1 или 1–6, динамическийНет
Орг-режимНетНетдаНетНетНет1– + ∞альтернатива [45] [46] [47]
PmWikiНетНетНетдаНетНеобязательный1–6Нет

Org-mode поддерживает отступы как средство указания уровня.

BBCode вообще не поддерживает заголовки разделов.

POD и Textile вместо этого выбирают соглашение HTML о нумерованных уровнях заголовков.

Другие форматы заголовков
ЯзыкФормат
POD
= head1 Заголовок уровня 1= head2 Заголовок уровня 2
Текстиль , [43] Jira [3]
h1. Заголовок уровня 1h2. Заголовок уровня 2h3. Заголовок уровня 3h4. Заголовок уровня 4h5. Заголовок 5-го уровняh6. Заголовок уровня 6

Microsoft Word поддерживает автоматическое форматирование абзацев в качестве заголовков, если они содержат не более нескольких слов, без точки в конце и если пользователь дважды нажимает клавишу ввода. Для более низких уровней пользователь может нажать клавишу табулятора соответствующее количество раз перед вводом текста, т. Е. С одной по восемь вкладок для уровней заголовков со второго по девятый.

Синтаксис ссылки [ править ]

Гиперссылки могут быть добавлены в строку, что может загромождать код из-за длинных URL-адресов, или с именованными aliasили пронумерованными idссылками на строки, не содержащие ничего, кроме адреса и связанных атрибутов, и часто могут быть расположены в любом месте документа. Большинство языков позволяют автору указывать текст, Textкоторый будет отображаться вместо простого адреса, http://example.comа некоторые также предоставляют методы для установки другого заголовка ссылки, Titleкоторый может содержать дополнительную информацию о месте назначения.

LML, адаптированные для специальных настроек, например вики или документации по коду, могут автоматически генерировать именованные якоря (для заголовков, функций и т. Д.) Внутри документа, ссылаться на связанные страницы (возможно, в другом пространстве имен) или обеспечивать текстовый поиск связанных ключевых слов .

Большинство языков используют (двойные) квадратные или угловые скобки для окружения ссылок, но вряд ли какие-либо два языка полностью совместимы. Многие могут автоматически распознавать и анализировать абсолютные URL-адреса внутри текста без дополнительной разметки.

Синтаксис гиперссылки
ЯзыкиБазовый синтаксисТекстовый синтаксисСинтаксис заголовка
BBCode, креольский, MediaWiki, PmWikihttp://example.com
Текстиль"Text":http://example.com"Text (Title)":http://example.com
Текси!"Text .(Title)":http://example.com
AsciiDochttp://example.com[Text]
Слабина<http://example.com|Text>
TiddlyWiki[[Text|http://example.com]]
Jira[http://example.com][Text|http://example.com]
txt2tags[Text http://example.com]
MediaWiki[http://example.com Text]
Креольский, MediaWiki, PmWiki[[Name]][[Name|Text]]
Орг-режим[[Name][Text]]
TiddlyWiki[[Text|Name]]
Креольский[[Namespace:Name]][[Namespace:Name|Text]]
Орг-режим[[Namespace:Name][Text]]
Креольский, PmWiki[[http://example.com]][[http://example.com|Text]]
BBCode[url]http://example.com[/url][url=http://example.com]Text[/url]
Markdown<http://example.com>[Text](http://example.com)[Text](http://example.com "Title")
reStructuredText`Text <http://example.com/>`_
PODL</Name>
PODL<http://example.com/>
Gemtext=> gemini://example.com=> gemini://example.com Text

Ссылки Gemtext должны быть в строке сами по себе, их нельзя использовать в строке.

Справочный синтаксис
ЯзыкиТекстовый синтаксисСинтаксис заголовка
reStructuredText
… Name_… ..  _Name: http://example.com
ATX
… [Текст]…[Текст] http://example.com
AsciiDoc
… [[я бы]] …<<id>>
… [[я бы]] …<< id, текст >>
… Якорь: id…xref: id
… Якорь: id…xref: id [Текст]
Markdown
… [ Текст ] [ id ]…[ id ]: http://example.com
… [ Текст ] [ id ]…[ id ]: http://example.com "Название"
… [ Текст ] []…[ Текст ]: http://example.com
… [ Текст ] []…[ Текст ]: http://example.com "Название"
… [Текст]…[ Текст ]: http://example.com
… [Текст]…[ Текст ]: http://example.com "Название"
Текстиль
… «Текст»: псевдоним…[псевдоним] http://example.com
… «Текст»: псевдоним…[псевдоним (Название)] http://example.com
Текси!
… «Текст»: псевдоним…[псевдоним]: http://example.com
… «Текст»: псевдоним…[псевдоним]: http://example.com. (Название)

Обычный синтаксис ссылок Org-mode выполняет текстовый поиск файла. Вы также можете установить специальные цели с помощью <<id>>.


Синтаксис списка [ править ]

HTML требует явного элемента для списка с указанием его типа и по одному для каждого элемента списка, но для большинства облегченных языков разметки требуются только разные префиксы строк для пунктов маркированного списка или пронумерованных элементов. Некоторые языки используют отступы для вложенных списков, другие используют повторяющиеся маркеры родительского списка.

Неупорядоченные элементы маркированного списка
Символы:*-+#.·•_:–—отступпропускатьгнездо
MarkdownдададаНетНетНетНетНетНетНетНет0–31–3отступ
MediaWiki , TiddlyWikiдаНетНетНетНетНетНетНетНетНетНет01+повторение
Орг-режимДа [48]дадаНетНетНетНетНетНетНетНет0+отступ
JiraдадаНетНетНетНетНетНетНетНетНет01+повторение
GemtextдаНетНетНетНетНетНетНетНетНетНет01+Нет

Microsoft Word автоматически преобразует абзацы, начинающиеся со звездочки *, дефис-минус -или скобки, >за которыми следует пробел или горизонтальный табулятор, в элементы маркированного списка. Он также начнет нумерованный список для цифры 1 и букв без учета регистра a (для алфавитных списков) или i (для римских цифр), если за ними следует точка ., закрывающая круглая скобка ), знак "больше" >или дефис-минус -и пробел или табуляция; в случае круглой скобки также поддерживается необязательная открывающая скобка (перед маркером списка.

Языки различаются по тому, поддерживают ли они необязательные или обязательные цифры в элементах нумерованного списка, какие типы счетчиков они понимают (например, десятичная цифра 1 , римские цифры i или I , буквенные буквы a или A ) и поддерживают ли они сохранение явных значений в выводе формат. Например, некоторые диалекты Markdown будут уважать начальное значение, отличное от 1, но игнорировать любое другое явное значение.

Упорядоченные, нумерованные элементы списка
Символы:##11.1)1]1}(1)[1]{1}a.A.i.I.отступпропускатьгнездо
MarkdownНетНетдадаНетНетНетНетНетНетНетНетНет0–31–3отступ
MediaWiki , TiddlyWikiдаНетНетНетНетНетНетНетНетНетНетНетНет01+повторение
Орг-режимНетНетдадаНетНетНетНетНетНеобязательныйНетНет0+отступ
JiraдаНетНетНетНетНетНетНетНетНетНетНетНет01+повторение

Slack помогает пользователю вводить нумерованные и маркированные списки, но на самом деле не форматирует их как таковые, то есть просто включает начальную цифру, за которой следует точка и пробел или маркер •перед строкой.

Метки, глоссарий, синтаксис списка определений
ЯзыкиСрок уточняетсяОпределение термина
MediaWiki; Term: Definition
TiddlyWiki
Орг-режим- Term :: Definition


См. Также [ править ]

  • Легкий язык программирования
  • Сравнение языков разметки документов
  • Сравнение генераторов документации
  • WikiText
  • Markdown

Ссылки [ править ]

  1. ^ "AsciiDoc ChangeLog" . Проверено 24 февраля 2017 .
  2. ^ "Версии WikiCreole" . Проверено 24 февраля 2017 .
  3. ^ а б Jira. «Справка по форматированию текста» . Atlassian . Проверено 22 декабря 2020 .
  4. ^ «Уценка» . Аарон Шварц: Интернет-блог . 2004-03-19.
  5. ^ «Дерзкий огненный шар: Markdown» . Архивировано из оригинала на 2004-04-02 . Проверено 25 апреля 2014 .
  6. ^ «PHP Markdown Extra» . Мишель Фортин . Проверено 8 октября 2013 .
  7. ^ «PHP Markdown: История» . Мишель Фортин . Проверено 23 декабря 2020 .
  8. ^ «История MediaWiki» . Проверено 24 февраля 2017 .
  9. ^ a b c Pandoc , написанный на Haskell , анализирует Markdown (в двух формах) и ReStructuredText , а также HTML и LaTeX; он записывает из любого из этих форматов в HTML , RTF , LaTeX , ConTeXt , OpenDocument , EPUB и несколько других форматов, включая (через LaTeX) PDF.
  10. ^ "Режим организации для Emacs - Ваша жизнь в виде простого текста" . orgmode.org . Команда OrgMode . Проверено 9 декабря 2016 .
  11. ^ "PmWiki Cookbook - экспорт дополнений" . Проверено 7 января 2018 .
  12. ^ «Введение в reStructuredText» . Проверено 24 февраля 2017 .
  13. ^ «Справочный центр Slack> Использование Slack> Отправлять сообщения> Форматировать сообщения» . Проверено 7 августа 2018 .
  14. ^ «Документация по Slack API: базовое форматирование сообщений» . Проверено 7 августа 2018 .
  15. ^ "История TiddlyWiki" . tiddlywiki.com .
  16. ^ «Текстизм› Инструменты ›Текстиль» . textism.com . Архивировано из оригинального 26 декабря 2002 года.
  17. ^ "Что такое Texy" . Проверено 24 февраля 2017 .
  18. ^ "Модуль Html2wiki txt2tags" . cpan.org . Проверено 30 января 2014 .
  19. ^ "Руководство пользователя Txt2tags" . Txt2tags.org . Проверено 24 февраля 2017 .
  20. ^ "Журнал изменений txt2tags" . Проверено 24 февраля 2017 .
  21. ^ «WhatsApp FAQ: Форматирование сообщений» . Проверено 21 ноября 2017 .
  22. ^ "Руководство пользователя Txt2tags" . Txt2tags.org . Проверено 24 февраля 2017 .
  23. ^ «Конвертеры» . WikiCreole . Проверено 8 октября 2013 .
  24. ^ pegdown : библиотека Java для обработки Markdown
  25. ^ a b gfms : Сервер разметки со вкусом Github
  26. ^ a b отмечено : полнофункциональный анализатор и компилятор уценки, написанный на JavaScript. Создан для скорости.
  27. ^ a b node-gfm : конвертер разметки в HTML со вкусом GitHub
  28. ^ Parsedown : парсер Markdown, написанный на PHP
  29. ^ a b Ciconia : парсер Markdown, написанный на PHP
  30. ^ a b Grip : предварительный просмотр Readme на GitHub
  31. ^ github-markdown : Автономный парсер Markdown для GitHub
  32. ^ Пег-уценка является реализацией уценки в C .
  33. ^ Discount также реализация уценки в C .
  34. ^ "Python-Markdown" . Github.com . Проверено 8 октября 2013 .
  35. ^ Брюс Уильямс < http://codefluency.com >, для Ruby Central < http://rubycentral.org >. "kramdown: Информация о проекте" . RubyForge. Архивировано из оригинала на 2013-08-07 . Проверено 8 октября 2013 .
  36. ^ a b "Через ox-pandoc и сам pandoc" .
  37. ^ Atlassian. «Редактор Confluence 4.0 - Что изменилось для пользователей разметки Wiki (разметка Confluence Wiki мертва)» . Проверено 28 марта 2018 .
  38. ^ Docutils - это реализация ReStructuredText в Python
  39. ^ Sphinx является реализация ReStructuredText в Python и Docutils с числом форматов вывода строителей
  40. ^ Аурелио Джаргас www.aurelio.net (2012-01-11). "txt2tags" . txt2tags . Проверено 8 октября 2013 .
  41. ^ "txt2tags.class.php - онлайн-конвертер [sic]" . Txt2tags.org . Проверено 8 октября 2013 .
  42. ^ "Синтаксис Markdown" . Daringfireball.net . Проверено 8 октября 2013 .
  43. ^ a b Текстильный синтаксис Архивировано 12 августа 2010 г. в Wayback Machine
  44. ^ "atx, истинный формат структурированного текста" Аарона Шварца (2002)
  45. ^ «Руководство организации: раздел« Более четкое представление структуры » » . Дата обращения 14 июня 2020 .
  46. ^ "используя org-adaptor-indentation" .
  47. ^ "используя org-indent-mode или org-indent" .
  48. ^ Сноска в официальном руководстве "При использовании символа '*' в качестве маркера строки должны иметь отступ, чтобы они не интерпретировались как заголовки. Кроме того, когда вы скрываете ведущие звезды, чтобы получить четкий вид контура, простые элементы списка начинаются со звезды может быть трудно отличить от настоящих заголовков. Вкратце: даже если '*' поддерживается, может быть лучше не использовать его для простых элементов списка ».

Внешние ссылки [ править ]

  • Список C2
  • Curl Markup для замены HTML + CSS + JS
  • Жители авторской экосферы
  • Список на сайте otl
  • Гуманные текстовые форматы - сравнение (устарело)
  • Pandoc: универсальный межформатный конвертер