yarmolinskiyam-yandex
Немного о Markdown
Как и многое на гитхабе, документ который ты читаешь написан не в MS Word или Google Docs, а в обычном текстовом редакторе с использованием языка разметки Markdown. Что же такое Markdown?
Markdown - это облегченный язык разметки, созданный для обозначения форматирования в простом тексте, с максимальным сохранением его читаемости человеком, и пригодный для машинного преобразования в языки для дальнейшей публикации, такие как HTML, Rich Text и другие.
Создатели Markdown, Джон Грубер и Аарон Шварц, стремились к быстрому форматированию статей. Они хотели, чтобы исходный текст материала оставался читаемым даже без преобразования в веб-страницу.
Markdown поддерживает следующие элементы разметки:
-
Заголовки:
Заголовки создаются с помощью символа “#”, где количество символов “#” определяет уровень заголовка. Например, “# Заголовок 1” будет заголовком первого уровня, а “## Заголовок 2” - заголовком второго уровня 3.
- Списки:
- Списки создаются с помощью символов “*”, “-“ или “+”.
- Для создания вложенных списков используются отступы.
- Как здесь.
-
Выделение текста: Текст можно выделить курсивом, жирным или
зачеркнутым. Для этого используются символы “*”, “_” или “~~”. -
Цитаты: Цитаты создаются с помощью символа “>” перед текстом цитаты.
- Код: Код в Markdown может быть внутри строки (inline) либо многострочными блоками.
Внутри строки код выделяется символом:“`” (обратный апостроф).print("Многострочный блок кода обозначается тремя апострофами"... " или отбивкой четырьмя пробелами или табом"... " с возможностью указания языка для корректной подстветки синтаксиса") - Ссылки и изображения: Ссылки и изображения в Markdown создаются с помощью специального синтаксиса. Например, ссылка создается в виде текст ссылки, а изображение - в виде
.
-
Таблицы: В некоторых диалектах Markdown, таких как GitHub Flavored Markdown, есть возможность создавать таблицы. Столбцы разделяются вертикальными линиями “ ”, а строка с шапкой отделяется от остальных дефисами “-“.
| Например | Вот | Так |
|----------|----------|----------|
| Row 1 | Cell 2 | Cell 3 |
| Row 2 | Cell 5 | Cell 6 |
| Row 3 | Cell 8 | Cell 9 |
| Например | Вот | Так |
|---|---|---|
| Row 1 | Cell 2 | Cell 3 |
| Row 2 | Cell 5 | Cell 6 |
| Row 3 | Cell 8 | Cell 9 |
И где этот Markdown нужен?
Markdown широко используется в программировании для написания документации, блогов и других текстовых материалов. Он поддерживается многими системами контроля версий, включая Git, и многими системами управления контентом, включая WordPress и GitHub 5.
Одно из главных преимуществ этого формата относительно RichText форматов .doc/.docx/.odt является то, что файл .md - это обычный текстовый файл, который можно открыть и редактировать в любом блокноте. Он имеет очень маленький размер файла, легко читаем и много где используется. А самое главное - он позволяет сосредоточится на наборе текста без отвлеканий на полетевшие шрифты и поехавшее форматирование.
Задание 1
В качестве первого задания тебе необходимо создать новый текстовый файл в формате Markdown с названием: README.md. Написать туда заголовком первого уровня “Знакомство с Markdown и GitHub”, после чего обычным текстом написать свои имя, фамилию и класс. После чего написать один-два абзаца о каком-нибудь событии, явлении, факте, алгоритме, методе (можно взять из сочинения, с википедии, откуда угодно), применив методы форматирования текста, а именно:
- заголовки второго и третьего уровней,
- список (либо нумерованный, либо ненумерованный),
- выделение текста (курсив, жирный и зачеркнутый),
- цитату,
- код (либо встроенный, либо многострочный),
- изображение.
Задание 2
Добавить файл PI.md и написать в нем число Пи с точностью не менее 100 знаков после запятой. В главном файле README.md добавить ссылку на него следующим образом: [Название ссылки](/PI.html). В результате на сайте должна быть ссылка, при нажатии на которую открывается страница с числом Пи.