Lebedkin.md 7.1 KB
Md-file
MD- говоря простыми словами, это текстовый документ, с возможностью разметки. Он чаще используется в Git для документирования проекта. "Описание для всех", если можно так сказать. Мое мнение после нескольких лет прерывного использования изменилось в лучшую сторону... Если дать шанс, то не пожалеешь об этом, ибо простота и удобство сравнимо с читами в какой-нибудь игре. Начнем по порядку заголовки: имеют несколько вариантов использования, и эти варианты подразделяются на несколько подтипов в зависимости от нужды например:
Заголовок первого уровня
========================
Заголовок второго уровня
-------------------------
Заголовки первого, третьего и шестого уровней, выполненные с помощью символа («#»), выглядят так:
# Заголовок первого уровня
### Заголовок третьего уровня
###### Заголовок шестого уровня
Приведенные выше заголовки, выполненные с помощью зажатого символа («#»):
# Заголовок первого уровня #
### Заголовок третьего уровня ###
###### Заголовок шестого уровня ######
Я в своей практике подавляющее количество раз использовал # перед тестом. Я считаю это более удобным и быстрым, но каждому своё.
Для обозначения цитат в языке Markdown используется знак «больше» («>»). Его можно вставлять как перед каждой строкой цитаты, так и только перед первой строкой параграфа. Также синтаксис Markdown позволяет создавать вложенные цитаты. Для их разметки используются дополнительные уровни знаков цитирования («>»). Цитаты мной были использованы реже, да и не по назначению. Их я использовал для выделения главного абзаца в тексте Ибо нет смысла в тупом цитировании.
Цитаты в языке Markdown выглядят следующим образом:
Это пример цитаты, в которой перед каждой строкой ставится угловая скобка. (не удобно)
Это пример цитаты, в которой угловая скобка ставится только перед началом нового параграфа. Второй параграф. (практичнее)
Вложение цитаты в цитату выглядит следующим образом: > Первый уровень цитирования >> Второй уровень цитирования >>> Третий уровень цитирования (данную функцию я не использовал вообще)
Markdown также поддерживает два стиля оформления ссылок:
- Гиперссылка, с немедленным указанием адреса;
- Гиперссылка, подобная сноске.
Подразумевается, что помимо URL-адреса существует еще текст ссылки. Он заключается в квадратные скобки. Для создания внутритекстовой гиперссылки необходимо использовать круглые скобки сразу после закрывающей квадратной. Внутри них необходимо поместить URL-адрес. В них же возможно расположить название, заключенное в кавычки, которое будет отображаться при наведении, но этот пункт не является обязательным.
[пример](http://example.com/ "Необязательная подсказка")
Эту функцию я использовал часто, чтобы сократить видимый текст, скрывая его в картинках. Вначале просто использовал ссылки прямо на картинки с другого сайта. но после совета, я стал делать отдельную папку с картинками на Git чтобы они не пропали, даже если статья пропадёт. В плюсы такого метода можно отнести говорящее название всех изображений, но в минусы затраты времени т.к. нужно их скачать ,при необходимости конвертировать в нужный формат, перенести его на Git и указать в тексте путь к изображению.
Выделение текста
Markdown воспринимает звёздочки «*» и символы подчёркивания «_» как признаки смыслового выделения текста:
Иными словами, текст, окруженный одинарными символами, выделяется курсивным шрифтом, Также, выделенный фрагмент может находиться в любой части слова. Текст, выделенный курсивом с использованием фишек языка Markdown, выглядит следующим образом:
Звезда
Подчеркивание
А текст, окруженный двойными символами, выделяется полужирным шрифтом с использованием фишек языка Markdown, выглядит следующим образом:
Звезда
Подчеркивание
Текст, выделенный курсивным полужирным шрифтом с использованием синтаксиса языка Markdown выглядит следующим образом:
Звезда
Подчеркивание
Я привел только несколько удобных фишек языка MD, чтобы новички могли попробовать базовые вещи языка и возможно это изменит ваше мнение на счёт этого языка.