Информационные технологии

2. Язык разметки markdown

Краткие теоретические сведения

Лекция

Язык разметки.

Язык разметки текста позволяет управлять оформлением (внешним видом) отдельных элементов текста. Управление осуществляется с помощью специальных символов или групп символов, которые обычно называют тег.

Процесс отображения оформления текста может называться по-разному, например: интерпретация, рендеринг или сборка документа. Далее будем использовать термин сборка.

Одним из наиболее простых языков разметки является markdown. Среди других языков стоит выделить HTML (используется для оформления web-страниц) и Latex (оформление научных статей и других документов). Популярный текстовый редактор Word также использует собственный язык разметки для внутреннего представления данных.

Тег markdown представляет собой символ или группу символов. Возможно два способа применения тегов. Если тэг стоит в начале строки, то он действует на все символы строки. Если тэг стоит в начале и конце фрагмента текста, то он действует на этот фрагмент текста.

Например, тег «>» действует на текст, оформляя его как цитату. Тег «_» применяется попарно и выделяет фрагмент текста между парой тегов курсивом. Следующей фрагмент текста:

 Пример цитаты с \_курсивом\_.

После сборки будет выглядеть так:

Пример цитаты с курсивом.

Для работы с markdown в редакторе vs code можно использовать расширение «Markdown All in One», которое позволяет просмотреть собранный документ (с поддержкой различных дополнений к markdown, например, математических формул), преобразовать его в HTML и другие операции.

Структура документа

Текст документа состоит из слов. Слова отделяются друг от друга пробелами или символами табуляции или конца строки. Независимо от количества пробелов или наличия символов табуляции и конца строки после сборки между словами будет один пробел.

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

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

Markdown поддерживает шесть уровней разделов, которые обозначаются с помощью числительных. В раздел первого уровня входят разделы второго уровня и так далее. Каждый раздел начинается с заголовка раздела, который занимает отдельную строку. Эта строка начинается с некоторого количеств символов #, количество которых соответствует уровню раздела.

Теги

Парные теги:

Тег Значение
* или _ курсив
** жирный
~~ зачеркнутый
*** жирный с курсивом

Строчные теги:

Тег Значение
> цитата
>> вложенная цитата
4 пробела выделенный абзац
* или - или + элемент маркированного списка
  1. (цифра любая) | элемент нумерованного списка

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

```\* – это звездочка, а не *курсив* и не список```

соберется как:

* – это звездочка, а не курсив и не список.

Вставки

В дополнение к отформатированному тексту в markdown можно вставить дополнительные элементы.

Для вставки гиперссылки используется следующая конструкция:

[Текст](ссылка)

Например, исходный текст:

[Поисковая система Яндекс](http://yandex.ru)

соберется как: Поисковая система Яндекс.

Для вставки картинки используется следующая конструкция:

![альтернативный текст](ссылка на картинку)

Альтернативный текст будет показываться в то время, когда картинка загружается. Например, исходный текст:

![Логотип markdown](https://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg)

будет собран в такую картинку: Логотип markdown.

Для вставки более сложных элементов (например, видео) или использования более сложных элементов оформления в исходный текст на языке markdown могут быть вставлены теги языка HTML. Например, следующим образом можно создать метку в тексте:

<a name="label">на этот текст мы сможем сделать гиперссылку</a>

а затем сослаться на нее:

[гиперссылка на метку](#label)

Задание к работе

Для выполнения лабораторной работы рекомендуется установить расширение «Markdown All in One» для редактора «VS code».

  1. Документ.
    1. Создайте и откройте в редакторе «VS code» файл с расширением «.md» (файл с текстом в формате языка разметки markdown). Этот файл будет использоваться для создания документа для отчета по лабораторной работе. Убедитесь, что установлена кодировка «UTF-8».
    2. Вставьте в текст следующие строки:
      # Основы работы с markdown
      ## Документ
      Структура документа задается с помощью заголовков. Заголовки задаются …
      
    3. Откройте окно предпросмотра документа с помощью команды «Markdown: Open Preview» («Ctrl–Shift–V»).
    4. Закончите мысль раздела документа относительно структуры markdown документов, переписав теоретические сведения своими словами.
    5. Добавьте в документ заголовки второго уровня для каждого пункта из задания к работе.
  2. Теги
    1. В начало документа добавьте раздел второго уровня с содержанием документа. Заполните этот раздел с помощью нумерованного списка с текстом из заголовков второго уровня (заголовок раздела с содержанием в содержание не включать).
    2. В раздел «Теги» перепишите содержание теоретической части в виде вложенного маркированного списка. Во внешнем списке должны быть перечислены типы тегов, во вложенном — тэги соответствующего типа (с примером).
    3. В этот же раздел добавьте примеры использования строчных тегов.
  3. Вставки
    1. В раздел «Вставки» напишите короткую информацию о себе и вставьте ссылку на свою страницу ВКонтакте. Далее вставьте свою фотографию.
    2. Соберите документ в формате HTML.