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