MarkDown – что это?

Rafael

Posted on Jul 8 • Edited on Jul 11

MarkDown – что это?

• Markdown — это язык разметки, с упрощенным до человекочитаемости синтаксисом.
• Markdown — создан Джоном Грубером (John Gruber) в 2004 году.
• Markdown — это фактически “микро” язык для трансляции “текста markdown” в подмножество языка HTML.
  • Markdown его итоговая презентация текста всегда документ HTML, и только потом если нужно следующим шагом PDF, др. стандарты документации.
  • Markdown принципиально не может задействовать весь потенциал HTML, результатом его работы всегда является ограниченный набор элементов.
  • Markdown — это транслятор который при анализе интегрированного в “текст” markdown HTML кода обязан по стандарту просто его транслировать в итоговый образ документа.

MarkDown – для чего создал его автор?

Первопричина — зубодробительная визуальная сложность языка разметки HTML. Автор просто хотел создать Markdown как слой абстракции между человеком и HTML (см. приложение)

«Markdown — это инструмент преобразования текста в HTML для веб-писателей. Markdown позволяет писать в легко читаемом и удобном для написания текстовом формате, а затем преобразовывать его в структурно корректный HTML.»
John Gruber

• Markdown.pl — это оригинальный Perl‑скрипт, созданный Джоном Грубером в 2004 году (при участии Аарона Шварца) как эталонная реализация языка разметки Markdown в HTML

Примечание

• Термин «транслятор» необходимо понимать как сущность «алгоритм».

• /

  • (1) Первоначальное назначение — “язык” для блога, как средство уменьшение когнитивной нагрузки на автора при написании блога, и автоматизации его трансляции в HTML.
  • (2) Второе назначение — “язык” документирования, на котором пишут “исходники документов” из которого принципам информационных систем формируют базу (см.DITA), которая выступает единым источником информации и исходящих документов, для:
    • Технической документации;
    • Пользовательской документации;
    • Маркетинговой документации;
    • Архитектурной(проектной) документации;
    • Личной базы знаний;
  • (3) Третье назначение — “язык” для ИИ, так как структурно идеально подошла для взаимодействия с агентами AI.

• /

• Я не нашел программу-редактор, реализующую концепт Markdown по принципам Джона Грубера (John Gruber).

  • Ни один редактор не умеет создавать из Markdown валидный по Груберу HTML.
  • Все проверенные мною программы (Obsidian, MarkText, Typora) на выходе из 10 строк текста генерируют портянку HTML в несколько тысяч строк!
  • Причина: Obsidian, Typora и MarkText используют Markdown не для веб-писателей и блогеров, а как формат хранения баз знаний (Knowledge Management).
  • Полностью соответствующие принципам Джона Грубера продукты на 2026 год — это программы-конвертеры из Markdown в HTML.

Ресурсы

1. В общем: Markdown — Википедия
2. Основной стандарт: CommonMark
3. Описание :What is Markdown? ║CommonMark Spec
4. Создатель: John Gruber – Wikipedia
   • Daring Fireball
   • 

Приложение

Код Markdown

# Пример Синтаксиса MarkDown
## Деревья
***
* Создать План темы
  * Выписать источники
    * Основные источники
    * Дополнительные
  * Посмотреть тематические видео
***
# Пример  таблица данных:

| ID | Название задачи | Статус |
|:---|:---|:---:|
| 01 | Верстка макета | Готово |
| 02 | Интеграция API | В процессе |

***
![Wikipedia](https://upload.wikimedia.org/wikipedia/commons/thumb/8/80/Wikipedia-logo-v2.svg/120px-Wikipedia-logo-v2.svg.png)

Enter fullscreen mode Exit fullscreen mode

Код HTML

<h1>Пример Синтаксиса MarkDown</h1>
<h2>Деревья</h2>
<hr>
<ul>
<li>Создать План темы
<ul>
<li>Выписать источники
<ul>
<li>Основные источники</li>
<li>Дополнительные</li>
</ul>
</li>
<li>Посмотреть тематические видео</li>
</ul>
</li>
</ul>
<hr>
<h1>Пример  таблица данных:</h1>
<table><thead><tr><th style="text-align: left;">ID</th><th style="text-align: left;">Название задачи</th><th style="text-align: center;">Статус</th></tr></thead><tbody><tr><td style="text-align: left;">01</td><td style="text-align: left;">Верстка макета</td><td style="text-align: center;">Готово</td></tr><tr><td style="text-align: left;">02</td><td style="text-align: left;">Интеграция API</td><td style="text-align: center;">В процессе</td></tr></tbody></table>
<hr>
<p><img alt="Wikipedia" src="https://upload.wikimedia.org/wikipedia/commons/thumb/8/80/Wikipedia-logo-v2.svg/120px-Wikipedia-logo-v2.svg.png"></p>

Enter fullscreen mode Exit fullscreen mode

Содержание

• MarkDown – что это?
  • MarkDown – для чего создал его автор?
• Примечание
• Ресурсы
• Приложение