Легкий язык разметки ( LML ), также называемый простой или гуманного язык разметки , это язык разметки , с помощью простого, ненавязчивого синтаксиса . Он разработан таким образом, чтобы его было легко писать с помощью любого обычного текстового редактора и легко читать в необработанном виде. Облегченные языки разметки используются в приложениях, где может потребоваться прочитать необработанный документ, а также окончательный отрисованный вывод.
Например, человек, загружающий библиотеку программного обеспечения, может предпочесть читать документацию в текстовом редакторе, а не в веб-браузере. Другое применение таких языков - обеспечение ввода данных в веб-публикациях , таких как веб-журналы и вики , где интерфейс ввода представляет собой простое текстовое поле . Затем серверное программное обеспечение преобразует ввод в общий язык разметки документов, такой как HTML .
История
Изначально облегченные языки разметки использовались только для текстовых дисплеев, которые не могли отображать символы курсивом или жирным шрифтом , поэтому пришлось разработать неформальные методы передачи этой информации. Этот выбор форматирования, естественно, был применен к обычным текстовым сообщениям электронной почты. Консольные браузеры также могут прибегать к аналогичным соглашениям об отображении.
В 1986 году международный стандарт SGML предоставил средства для определения и анализа облегченных языков разметки с использованием грамматик и импликации тегов. W3C XML 1998 года - это профиль SGML, в котором эти возможности отсутствуют. Однако определение типа документа SGML (DTD) для любого из перечисленных ниже языков неизвестно.
Типы
Легкие языки разметки можно классифицировать по типам тегов. Как и HTML ( ), в некоторых языках используются именованные элементы, которые имеют общий формат для начальных и конечных тегов (например, BBCode ), тогда как правильные облегченные языки разметки ограничиваются только знаками препинания ASCII и другими небуквенными символами для тегов, но некоторые также смешайте оба стиля (например, Textile ) или разрешите встроенный HTML (например, Markdown ), возможно, расширенный пользовательскими элементами (например, MediaWiki ).bold
[b]bold[/b]
bq.
source
Большинство языков различают разметку для строк или блоков и для более коротких отрезков текста, но некоторые поддерживают только встроенную разметку.
Некоторые языки разметки предназначены для определенной цели, например, для документирования компьютерного кода (например, 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] |
Уценка | да | да | Нет | да | Да нет | Да нет | 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] |
Нет | Нет | Нет | Нет | Нет | Нет | 2016-03-16 [21] |
Собственный синтаксис Markdown не поддерживает атрибуты класса или атрибуты id; однако, поскольку Markdown поддерживает включение собственного HTML-кода, эти функции могут быть реализованы с использованием прямого HTML. (Некоторые расширения могут поддерживать эти функции.)
Собственный синтаксис txt2tags не поддерживает атрибуты класса или атрибуты id; однако, поскольку txt2tags поддерживает включение собственного кода HTML в области с тегами, эти функции могут быть реализованы с использованием прямого HTML при сохранении в целевой HTML. [22]
Сравнение возможностей реализации
Язык | Реализации | X HTML | Con / La TeX | DocBook | ODF | EPUB | ДОК (X) | LMLs | Другой | Лицензия | |
---|---|---|---|---|---|---|---|---|---|---|---|
AsciiDoc | Python , Ruby , JavaScript , Java | XHTML | Латекс | DocBook | ODF | EPUB | Нет | - | Страница руководства и т. Д. | GNU GPL, MIT | |
BBCode | Perl , PHP , C # , Python , Ruby | (X) HTML | Нет | Нет | Нет | Нет | Нет | Нет | - | - | Всеобщее достояние |
Креольский | PHP , Python , Ruby , JavaScript [23] | Зависит от реализации | CC_BY-SA 1.0 | ||||||||
Уценка со вкусом GitHub | Haskell ( Pandoc ) | HTML | LaTeX, ConTeXt | DocBook | ODF | EPUB | DOC | AsciiDoc , reST | OPML | GPL | |
Java , [24] JavaScript , [25] [26] [27] PHP , [28] [29] Python , [30] Ruby [31] | HTML [25] [26] [27] [29] [30] | Нет | Нет | Нет | Нет | Нет | Нет | - | - | Проприетарный | |
Уценка | Perl (изначально), C , [32] [33] Python , [34] JavaScript , Haskell , [9] Ruby , [35] C # , Java , PHP | HTML | LaTeX, ConTeXt | DocBook | ODF | EPUB | RTF | MediaWiki , reST | Страница руководства , S5 и т. Д. | BSD-стиль и GPL (оба) | |
Markdown Extra | PHP (изначально), Python , Ruby | XHTML | Нет | Нет | Нет | Нет | Нет | Нет | - | - | BSD-стиль и GPL (оба) |
MediaWiki | Perl , PHP , Haskell , Python | XHTML | Нет | Нет | Нет | Нет | Нет | Нет | - | - | GNU GPL |
MultiMarkdown | C , Perl | (X) HTML | Латекс | Нет | ODF | Нет | DOC, RTF | - | OPML | GPL , MIT | |
Орг-режим | Emacs Lisp , Ruby (только парсер), Perl , OCaml | XHTML | Латекс | DocBook | ODF | EPUB [36] | DOCX [36] | Уценка | TXT , XOXO , iCalendar , Texinfo , man , contrib: groff , s5 , deck.js, разметка Confluence Wiki, [37] TaskJuggler , RSS , FreeMind | GPL | |
PmWiki | PHP | XHTML 1.0 переходный, HTML5 | Нет | Дополнения для экспорта PDF | Нет | Нет | Дополнение для экспорта EPUB | Нет | - | - | GNU GPL |
POD | Perl | (X) HTML, XML | Латекс | DocBook | Нет | Нет | RTF | - | Страница руководства , простой текст | Художественная лицензия , лицензия Perl | |
reStructuredText | Python , [38] [39] Haskell (Pandoc) , Java , | HTML, XML | Латекс | DocBook | ODF | EPUB | DOC | - | человек , S5 , Devhelp , QT Help , CHM , JSON | Всеобщее достояние | |
Текстиль | PHP , JavaScript , Java , Perl , Python , Ruby , ASP , C # , Haskell | XHTML | Нет | Нет | Нет | Нет | Нет | Нет | - | - | Текстильная лицензия |
Текси! | PHP , C # | (X) HTML | Нет | Нет | Нет | Нет | Нет | Нет | - | - | Лицензия GNU GPL v2 |
txt2tags | Python , [40] PHP [41] | (X) HTML, SGML | Латекс | DocBook | ODF | EPUB | DOC | Creole , AsciiDoc , MediaWiki , MoinMoin , PmWiki , DokuWiki , Google Code Wiki | roff , человек , MagicPoint , Lout , PageMaker , ASCII Art , TXT | GPL |
Сравнение синтаксиса облегченного языка разметки
Встроенный синтаксис диапазона
Хотя обычно документируется выделение текста курсивом и полужирным шрифтом, большинство облегченных процессоров разметки выводят семантические элементы HTML em
и strong
вместо них. Моноширинный текст может иметь семантические code
или презентационные tt
элементы. Некоторые языки делают различие, например Textile, или позволяют пользователю легко настраивать вывод, например Texy.
LML иногда различаются для разметки из нескольких слов, где некоторые требуют, чтобы символы разметки заменяли межсловные пробелы ( инфикс ). Некоторые языки требуют использования одного символа в качестве префикса и суффикса, другие требуют удвоения или даже утроения или поддерживают оба символа с немного разным значением, например, с разными уровнями акцента.
Вывод HTML | strongly emphasized | emphasized text | | семантический |
---|---|---|---|---|
bold text | italic text | monospace text | презентационный | |
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 | N / A | N / A | ```alt 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'' | | в основном прибегает к встроенному HTML |
Орг-режим | *bold text* | /italic text/ | =code= | |
~verbatim~ | ||||
PmWiki | '''bold text''' | ''italic text'' | @@monospace text@@ | |
отдых | **bold text** | *italic text* | ``monospace text`` | |
Сетекст | **bold text** | ~italic text~ | N / A | |
Текстиль [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`` | |
POD | B | I | C | Текст с отступом также отображается как моноширинный код. |
Слабина | *bold text* | _italic text_ | `monospace text` | ```block of monospaced text``` |
*bold text* | _italic text_ | ```monospace text``` |
Gemtext не имеет встроенного форматирования, моноширинный текст (известный в сообществе Gemini форматированный текст) должен иметь начало и закрытие ```
на отдельных строках.
Синтаксис акцента
В HTML текст выделяется типами элементов и
, тогда как
и
традиционно выделяют текст курсивом или полужирным шрифтом соответственно.
Microsoft Word и Outlook и, соответственно, другие текстовые процессоры и почтовые клиенты, которые стремятся к тому, чтобы пользовательский интерфейс был похожим, поддерживают базовое соглашение об использовании звездочек для полужирного шрифта и подчеркивания для курсива. В то время как Word удаляет символы, Outlook сохраняет их.
Код | AsciiDoc | ATX | Креольский | Jira | Уценка | MediaWiki | Орг-режим | PmWiki | отдых | Сетекст | Слабина | Текстиль | Текси! | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
*italic* | Нет | Нет | Нет | Нет | да | Нет | Нет | Нет | да | Нет | Нет | Нет | да | Нет | Нет | Нет |
**italic** | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
_italic_ | да | да | Нет | да | да | Нет | Нет | Нет | Нет | Нет | да | да | Нет | Нет | Нет | да |
__italic__ | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | да | Нет | Нет | Нет | Нет |
'italic' | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
''italic'' | да | Нет | Нет | Нет | Нет | да | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
/italic/ | Нет | Нет | Нет | Нет | Нет | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
//italic// | Нет | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | да | да | да | Нет |
~italic~ | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет |
Код | AsciiDoc | ATX | Креольский | Jira | Уценка | MediaWiki | Орг-режим | PmWiki | отдых | Сетекст | Слабина | Текстиль | Текси! | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
*bold* | да | да | Нет | да | Нет | Нет | да | Нет | Нет | Нет | да | да | Нет | Нет | Нет | да |
**bold** | да | Нет | да | Нет | да | Нет | Нет | Нет | да | да | Нет | да | да | Нет | да | Нет |
__bold__ | Нет | Нет | Нет | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
''bold'' | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | да | Нет | Нет |
'''bold''' | Нет | Нет | Нет | Нет | Нет | да | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
Редакционный синтаксис
В HTML, удалены или удалены , и вставленный текст размечен с
и элементных типов, соответственно. Однако унаследованные типы элементов
или
и по-прежнему доступны для зачеркнутых и подчеркнутых участков текста.
Код | Jira | Уценка | Орг-режим | Сетекст | TiddlyWiki | txt2tags |
---|---|---|---|---|---|---|
_underline_ | Нет | По желанию | да | да | Нет | Нет |
__underline__ | Нет | По желанию | Нет | Нет | да | да |
+underline+ | да | Нет | Нет | Нет | Нет | Нет |
AsciiDoc, ATX, Creole, MediaWiki, PmWiki, reST, Slack, Textile, Texy! и WhatsApp не поддерживают специальную разметку для подчеркивания текста.
Код | Jira | Уценка | Орг-режим | Слабина | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|
~stricken~ | Нет | Нет | Нет | да | Нет | Нет | да |
~~stricken~~ | Нет | GFM | Нет | Нет | да | Нет | Нет |
+stricken+ | Нет | Нет | да | Нет | Нет | Нет | Нет |
-stricken- | да | Нет | Нет | Нет | Нет | Нет | Нет |
--stricken-- | Нет | Нет | Нет | Нет | Нет | да | Нет |
AsciiDoc, ATX, Creole, MediaWiki, PmWiki, reST, Setext, Textile и Texy! не поддерживают специальную разметку для зачеркивания текста.
Синтаксис программирования
Цитируемый компьютерный код традиционно представлен шрифтами, похожими на пишущую машинку, где каждый символ занимает одинаковую фиксированную ширину. HTML предлагает семантические и устаревшие
типы презентационных элементов для этой задачи.
Код | AsciiDoc | ATX | Креольский | Gemtext | Jira | Уценка | Орг-режим | PmWiki | отдых | Слабина | Текстиль | Текси! | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
@code@ | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | да | Нет | Нет | Нет | Нет |
@@code@@ | Нет | Нет | Нет | Нет | Нет | Нет | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
`code` | да | Нет | Нет | Нет | Нет | да | Нет | Нет | Нет | да | Нет | да | да | Нет | Нет |
``code`` | да | Нет | Нет | Нет | Нет | да | Нет | Нет | да | Нет | Нет | Нет | да | да | Нет |
```code``` | Нет | Нет | Нет | да | Нет | да | Нет | Нет | Нет | Да нет | Нет | Нет | да | Нет | да |
=code= | Нет | Нет | Нет | Нет | Нет | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
~code~ | Нет | Нет | Нет | Нет | Нет | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
+code+ | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
++code++ | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
{{code}} | Нет | Нет | Нет | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
{{{code}}} | Нет | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
|code| | Нет | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
Mediawiki, Setext и Gemtext не предоставляют облегченную разметку для встроенных участков кода.
Синтаксис заголовка
Заголовки обычно доступны на шести уровнях, но верхний часто зарезервирован для того, чтобы содержать то же самое, что и заголовок документа, который может быть установлен извне. В некоторой документации уровни могут быть связаны с типами подразделений, например, часть, глава, раздел, статья или абзац.
Большинство LMLs следует один из двух стилей для заголовков, либо Setext -как подчеркивание или АТЙ -как [44] маркеры линии, или они поддерживают оба.
Подчеркнутые заголовки
Заголовок уровня 1===============Заголовок уровня 2---------------Заголовок 3-го уровня~~~~~~~~~~~~~~~
В первом стиле используются подчеркивания, т. Е. Повторяющиеся символы (например =
, знак равенства , дефис -
или тильда ~
, обычно не менее двух или четырех раз) в строке под текстом заголовка.
Символы: | = | - | ~ | * | # | + | ^ | _ | : | " | ' | ` | . | мин |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Уценка | 1 | 2 | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | 1 |
Сетекст | 1 | 2 | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | ? |
AsciiDoc | 1 | 2 | 3 | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | 2 |
Текси! | 3 | 4 | Нет | 2 | 1 | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | 3 |
reStructuredText | да | да | да | да | да | да | да | да | да | да | да | да | да | ширина заголовка |
RST динамически определяет уровни заголовков, что, с одной стороны, делает создание более индивидуальным, а с другой - усложняет слияние из внешних источников.
Заголовки с префиксом
# Заголовок уровня 1## Заголовок 2-го уровня ##### Заголовок 3-го уровня ###
Второй стиль основан на повторяющихся маркерах (например, хэш #
, равно =
или звездочка *
) в начале самого заголовка, где количество повторений указывает (иногда обратный) уровень заголовка. Большинство языков также поддерживают дублирование маркеров в конце строки, но в то время как некоторые делают их обязательными, другие даже не ожидают совпадения их номеров.
Персонаж: | = | # | * | ! | + | Суффикс | Уровни | Отступ |
---|---|---|---|---|---|---|---|---|
AsciiDoc | да | Нет | Нет | Нет | Нет | По желанию | 1–6 | Нет |
ATX | Нет | да | Нет | Нет | Нет | Нет | неограниченный | ? |
Креольский | да | Нет | Нет | Нет | Нет | По желанию | 1–6 | Нет |
Gemtext | Нет | да | Нет | Нет | Нет | ? | 1–3 | Нет |
MediaWiki | да | Нет | Нет | Нет | Нет | да | 1–6 | Нет |
TiddlyWiki | Нет | Нет | Нет | да | Нет | Нет | 1–6 | Нет |
txt2tags | да | Нет | Нет | Нет | да | да | 1–6 | Нет |
Уценка | Нет | да | Нет | Нет | Нет | По желанию | 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. Заголовок 3-го уровняh4. Заголовок 4-го уровняh5. Заголовок 5-го уровняh6. Заголовок уровня 6 |
Microsoft Word поддерживает автоматическое форматирование абзацев в качестве заголовков, если они не содержат более нескольких слов, без точки в конце и если пользователь дважды нажимает клавишу ввода. Для более низких уровней пользователь может нажать клавишу табулятора соответствующее количество раз перед вводом текста, т. Е. С одной по восемь вкладок для уровней заголовков со второго по девятый.
Синтаксис ссылки
Гиперссылки могут быть добавлены в строку, что может загромождать код из-за длинных URL-адресов, или с именованными alias
или пронумерованными id
ссылками на строки, не содержащие ничего, кроме адреса и связанных атрибутов, и часто могут находиться в любом месте документа. Большинство языков позволяют автору указывать текст, Text
который будет отображаться вместо обычного адреса, http://example.com
а некоторые также предоставляют методы для установки другого заголовка ссылки, Title
который может содержать дополнительную информацию о месте назначения.
LML, адаптированные для специальных настроек, например вики или документации по коду, могут автоматически генерировать именованные якоря (для заголовков, функций и т. Д.) Внутри документа, ссылаться на связанные страницы (возможно, в другом пространстве имен) или обеспечивать текстовый поиск связанных ключевых слов. .
Большинство языков используют (двойные) квадратные или угловые скобки для окружения ссылок, но вряд ли какие-либо два языка полностью совместимы. Многие могут автоматически распознавать и анализировать абсолютные URL-адреса внутри текста без дополнительной разметки.
Языки | Базовый синтаксис | Текстовый синтаксис | Синтаксис заголовка |
---|---|---|---|
BBCode, креольский, MediaWiki, PmWiki | http://example.com | ||
Текстиль | "Text":http://example.com | "Text (Title)":http://example.com | |
Текси! | "Text .(Title)":http://example.com | ||
AsciiDoc | 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] | |
Уценка | | [Text](http://example.com) | [Text](http://example.com "Title") |
reStructuredText | `Text | ||
POD | L | ||
POD | L | ||
Gemtext | => gemini://example.com | => gemini://example.com Text |
Ссылки Gemtext должны быть в строке сами по себе, они не могут использоваться в строке.
Языки | Текстовый синтаксис | Синтаксис заголовка |
---|---|---|
reStructuredText | … Name_… .. _Name: http://example.com | |
ATX | … [Текст]…[Текст] http://example.com | |
AsciiDoc | … [[я бы]] …< | … [[я бы]] …<< id, текст >> |
… Привязка: id…xref: id | … Привязка: id…xref: id [Текст] | |
Уценка | … [ Текст ] [ 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 выполняет текстовый поиск файла. Вы также можете установить специальные цели с помощью <
.
Синтаксис списка
HTML требует явного элемента для списка с указанием его типа и по одному для каждого элемента списка, но для большинства облегченных языков разметки требуются только разные префиксы строк для пунктов маркированного списка или пронумерованных элементов. Некоторые языки используют отступы для вложенных списков, другие используют повторяющиеся маркеры родительского списка.
Символы: | * | - | + | # | . | · | • | _ | : | – | — | отступ | пропускать | гнездо |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Уценка | да | да | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | 0–3 | 1–3 | отступ |
MediaWiki , TiddlyWiki | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | 0 | 1+ | повторить |
Орг-режим | Да [48] | да | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | 0+ | отступ | |
Jira | да | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | 0 | 1+ | повторить |
Gemtext | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | 0 | 1+ | Нет |
Microsoft Word автоматически преобразует абзацы, начинающиеся со звездочки *
, дефис-минус -
или скобки больше, >
за которыми следует пробел или горизонтальный табулятор, в элементы маркированного списка. Он также начнет нумерованный список для цифры 1 и букв без учета регистра a (для алфавитных списков) или i (для римских цифр), если за ними следует точка .
, закрывающая круглая скобка )
, знак больше >
или дефис-минус -
и пробел или табуляция; в случае круглой скобки также поддерживается необязательная открывающая скобка (
перед маркером списка.
Языки различаются в зависимости от того, поддерживают ли они необязательные или обязательные цифры в элементах нумерованного списка, какие типы счетчиков они понимают (например, десятичная цифра 1 , римские цифры i или I , буквенные буквы a или A ) и поддерживают ли они сохранение явных значений в выводе. формат. Например, некоторые диалекты Markdown будут учитывать начальное значение, отличное от 1, но игнорировать любое другое явное значение.
Символы: | # | #1 | 1. | 1) | 1] | 1} | (1) | [1] | {1} | a. | A. | i. | I. | отступ | пропускать | гнездо |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Уценка | Нет | Нет | да | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | 0–3 | 1–3 | отступ |
MediaWiki , TiddlyWiki | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | 0 | 1+ | повторить |
Орг-режим | Нет | Нет | да | да | Нет | Нет | Нет | Нет | Нет | По желанию | Нет | Нет | 0+ | отступ | ||
Jira | да | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | Нет | 0 | 1+ | повторить |
Slack помогает пользователю вводить нумерованные и маркированные списки, но на самом деле не форматирует их как таковые, то есть просто включает начальную цифру, за которой следует точка и пробел или маркер •
перед строкой.
Языки | Срок уточняется | Определение термина |
---|---|---|
MediaWiki | ; Term | : Definition |
TiddlyWiki | ||
Орг-режим | - Term :: Definition |
Смотрите также
- Легкий язык программирования
- Сравнение языков разметки документов
- Сравнение генераторов документации
- WikiText
- Уценка
Рекомендации
- ^ "AsciiDoc ChangeLog" . Проверено 24 февраля 2017 .
- ^ "Версии WikiCreole" . Проверено 24 февраля 2017 .
- ^ а б Jira. «Справка по форматированию текста» . Atlassian . Проверено 22 декабря 2020 .
- ^ «Уценка» . Аарон Шварц: Интернет-блог . 2004-03-19.
- ^ «Дерзкий огненный шар: уценка» . Архивировано из оригинала на 2004-04-02 . Проверено 25 апреля 2014 .
- ^ «PHP Markdown Extra» . Мишель Фортин . Проверено 8 октября 2013 .
- ^ «PHP Markdown: История» . Мишель Фортин . Проверено 23 декабря 2020 .
- ^ «История MediaWiki» . Проверено 24 февраля 2017 .
- ^ a b c Pandoc , написанный на Haskell , анализирует Markdown (в двух формах) и ReStructuredText , а также HTML и LaTeX; он записывает из любого из этих форматов в HTML , RTF , LaTeX , ConTeXt , OpenDocument , EPUB и несколько других форматов, включая (через LaTeX) PDF.
- ^ «Режим организации для Emacs - Ваша жизнь в виде простого текста» . orgmode.org . Команда OrgMode . Проверено 9 декабря 2016 .
- ^ "PmWiki Cookbook - экспорт дополнений" . Проверено 7 января 2018 .
- ^ «Введение в reStructuredText» . Проверено 24 февраля 2017 .
- ^ «Справочный центр Slack> Использование Slack> Отправлять сообщения> Форматировать сообщения» . Проверено 7 августа 2018 .
- ^ «Документация по Slack API: базовое форматирование сообщений» . Проверено 7 августа 2018 .
- ^ «История TiddlyWiki» . tiddlywiki.com .
- ^ «Текстизм› Инструменты ›Текстиль» . textism.com . Архивировано из оригинального 26 декабря 2002 года.
- ^ «Что такое Текси» . Проверено 24 февраля 2017 .
- ^ «Модуль Html2wiki txt2tags» . cpan.org . Проверено 30 января 2014 .
- ^ «Руководство пользователя Txt2tags» . Txt2tags.org . Проверено 24 февраля 2017 .
- ^ "Журнал изменений txt2tags" . Проверено 24 февраля 2017 .
- ^ «WhatsApp FAQ: Форматирование сообщений» . Проверено 21 ноября 2017 .
- ^ «Руководство пользователя Txt2tags» . Txt2tags.org . Проверено 24 февраля 2017 .
- ^ «Конвертеры» . WikiCreole . Проверено 8 октября 2013 .
- ^ pegdown : библиотека Java для обработки Markdown
- ^ a b gfms : Сервер разметки со вкусом Github
- ^ a b отмечено : полнофункциональный анализатор и компилятор уценки, написанный на JavaScript. Создан для скорости.
- ^ a b node-gfm : конвертер разметки в HTML со вкусом GitHub
- ^ Parsedown : синтаксический анализатор Markdown, написанный на PHP.
- ^ a b Ciconia : синтаксический анализатор Markdown, написанный на PHP
- ^ a b Grip : предварительный просмотр Readme на GitHub
- ^ github-markdown : Автономный парсер Markdown для GitHub
- ^ Пег-уценка является реализацией уценки в C .
- ^ Discount также реализация уценки в C .
- ^ «Python-Markdown» . Github.com . Проверено 8 октября 2013 .
- ^ Брюс Уильямс < http://codefluency.com >, для Ruby Central < http://rubycentral.org >. "kramdown: Информация о проекте" . RubyForge. Архивировано из оригинала на 2013-08-07 . Проверено 8 октября 2013 .
- ^ а б "Через ox-pandoc и сам pandoc" .
- ^ Atlassian. «Редактор Confluence 4.0 - Что изменилось для пользователей разметки Wiki (разметка Confluence Wiki мертва)» . Проверено 28 марта 2018 .
- ^ Docutils - это реализация ReStructuredText в Python
- ^ Sphinx является реализация ReStructuredText в Python и Docutils с числом форматов вывода строителей
- ^ Аурелио Джаргас www.aurelio.net (11.01.2012). "txt2tags" . txt2tags . Проверено 8 октября 2013 .
- ^ "txt2tags.class.php - онлайн-конвертер [sic]" . Txt2tags.org . Проверено 8 октября 2013 .
- ^ «Синтаксис Markdown» . Daringfireball.net . Проверено 8 октября 2013 .
- ^ a b Текстильный синтаксис Архивировано 12 августа 2010 г. в Wayback Machine
- ^ "atx, истинный структурированный текстовый формат" Аарона Шварца (2002)
- ^ «Руководство организации: раздел« Более четкое представление структуры » » . Проверено 14 июня 2020 .
- ^ "используя org-Adapt-indentation" .
- ^ "используя org-indent-mode или org-indent" .
- ^ Сноска в официальном руководстве "При использовании символа '*' в качестве маркера строки должны иметь отступ, чтобы они не интерпретировались как заголовки. Кроме того, когда вы скрываете ведущие звезды, чтобы получить четкое представление контура, простые элементы списка начинаются со звезды может быть трудно отличить от настоящих заголовков. Вкратце: даже несмотря на то, что '*' поддерживается, может быть лучше не использовать его для простых элементов списка ".
Внешние ссылки
- Список C2
- Curl Markup для замены HTML + CSS + JS
- Жители авторской экосферы
- Список на сайте otl
- Гуманные текстовые форматы - сравнение (устарело)
- Pandoc: универсальный межформатный конвертер