Phenquestions
В то же время уценка очень легкая и гибкая. Самый популярный вариант использования уценки - это файлы License и README в репозитории GitHub, но он также интегрируется со все большим количеством CMS для управления сообщениями в блогах и даже для написания исследовательских работ. Вы можете отображать математические уравнения с помощью плагинов для LaTeX.
Однако в основном он используется разработчиками. Это действительно полезно при создании руководств и документации благодаря подсветке синтаксиса для нескольких языков и поддержке изображений и даже гифок.
Начнем с настройки, которая позволяет нам предварительно просмотреть визуализированный документ вместе с необработанным текстовым файлом уценки.
Текстовый редактор Atom и предварительный просмотр Markdown
Вы можете загрузить и установить текстовый редактор Atom или Visual Studio Code, чтобы следовать. У Atom и VS Code есть предустановленные плагины для Markdown Preview. Здесь будет использоваться Atom, но синтаксис останется примерно таким же, независимо от того, какой текстовый редактор вы используете.
На Atom убедитесь, что пакет Markdown Preview включен (по сути, он включен по умолчанию). Создайте папку для этого руководства по уценке, откройте там новый файл (CTRL + N) и введите следующий текст.
# Это заголовок___
## Это тоже заголовок
Вот какой-то текст
Сохраните файл (CRTL + S) с .md расширение. Например, вы можете назвать свой файл test.мкр и .md сообщит Atom, что это файл уценки, и расширение будет работать с ним, как задумано. Вы можете создать предварительный просмотр, используя следующую привязку клавиш (CTRL + SHIFT + M), которая отображается на новой панели рядом с исходным текстовым файлом.
Вы можете закрыть панель предварительного просмотра, используя ту же привязку клавиш или используя сам графический интерфейс.
Когда все настроено, мы можем более внимательно изучить синтаксис и начать создавать потрясающие документы на лету.
Синтаксис Markdown
Как упоминалось ранее, главная мотивация Markdown - удобочитаемость. Это означает отсутствие непонятных тегов или вложенных тегов или любых других строк, вызывающих путаницу. Вместо этого мы можем начать с символа '#', чтобы указать, что эта конкретная строка является заголовком.
# Заголовок.## Также указывает заголовок, но с меньшим размером шрифта.
### Вы можете последовательно уменьшать размер
Разрывы строк
Markdown продолжает объединять весь текст в один гигантский абзац, даже если исходный текст разбит на несколько разных строк. Чтобы смягчить это, вы можете использовать два пробела в конце строки, а затем поставить символ новой строки (то есть нажать
Предложение «Вот почему…» начинается с новой строки, но не отделяется от предыдущей строки, тогда как использование двух новых строк создает более широкое разделение.
Горизонтальное правило
Горизонтальная линейка, как следует из названия, создает горизонтальную линию, которая позволяет структурировать документ и делать в нем логические разделения. Есть два метода создания горизонтальной линейки. Во-первых, используйте три или более символа подчеркивания для создания горизонтальной линейки.
# Заголовок 1___
Абзац и заголовок разделены горизонтальной линейкой.
___
Еще один отдельный раздел
Другой вариант (который я не рекомендую) - использовать три или более дефиса '-', но они также используются, чтобы указать, что предложение непосредственно над ними является заголовком. Поэтому, если у вас нет новой строки между предложением и горизонтальной линейкой под ним, это предложение примет форму заголовка.
Курсив, полужирный и зачеркнутый
Синтаксис трех из них довольно прост и говорит сам за себя.
** Полужирным шрифтом **__Тоже жирный __
_Это курсив_
* Это тоже курсив *
~~ Это зачеркнутый ~~
Эскейп-персонаж
Теперь можно спросить, как бы вы буквально написали ** какой-то текст ** в окончательный файл уценки, если он просто меняет его на полужирный каждый раз. Это то, с чем также сталкиваются большинство языков программирования, и решение аналогично этим - используйте символ обратной косой черты. Это работает и для других элементов синтаксиса, а не специально для жирного стиля.
\ ** Это уже не жирный шрифт \ **Если вы хотите показать сам символ обратной косой черты, используйте два из них и так далее.
\\ Отображается как одинарная косая черта
Цитаты и блоки кода
Цитаты и блоки кода намного проще. Цитата может быть использована, чтобы выделить важный момент, на который вы хотите привлечь внимание читателей. Этого можно добиться, используя вначале прямоугольную скобу, как показано на рисунке.
# Заголовок 1Lorem ipsum dolor sit amet, conctetur adipiscing elit, sed do eiusmod tempor incididunt ut
labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud упражнения ullamco labouris
nisi ut aliquip ex ea Commodo Concequat. Duis aute irure dolor в репреендерит в сладострастии
velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat Cupidatat non
proident, sunt in culpa qui officia deserunt mollit anim id est Laborum.
> Это аккуратное резюме части вашего документа. A> пара строк, которые стоят
вне остального контента.
Содержание продолжается.
Вот как это выглядит при рендеринге.
Для блоков кода просто сделайте отступ между строками на 4 или более пробелов. Это действительно
удобно для разработчиков и операторов, которые хотят документировать свою работу. Позже мы увидим, как это сделать еще лучше.
Гиперссылки и изображения
Для гиперссылок синтаксис довольно прост. Видимый текст записывается в квадратных скобках, а URL, на который он указывает, записывается в круглых скобках рядом с ним.
Для изображений синтаксис аналогичен, за исключением того, что он начинается с восклицательного знака. Вы можете использовать относительный путь в папке проекта, который указывает на изображение, или у вас может быть общедоступный URL-адрес.
## Иллюстрация синтаксиса гиперссылки и изображения___
Вам следует [посетить нас] (https: // linuxhint.com) чаще
Так встраиваются изображения.
![SmugPug] (https: // загрузить.Викимедиа.org / wikipedia / commons / d / d2 / Bonny_Bonita.JPG)
Таблицы
Создание таблиц в markdown включает в себя буквально рисование портрета таблицы в формате ascii (точнее, Unicode).
## Таблицы| Колонка 1 | Колонка 2 | Колонка 3 |
| --------- | --------- | --------- |
| Первый ряд | Первый ряд | Первый ряд |
| Второй ряд | Второй ряд | Второй ряд |
Синтаксис не обязательно должен быть точно выровнен от одной строки к другой, но вертикальная черта используется для перехода к следующему столбцу, а следующая строка указывает, что следующая строка началась, как правило.
Расширенная уценка
Для тех из вас, кто зашел так далеко, вот настоящее удовольствие. Если вы используете Atom, вы можете заменить плагин Markdown Preview на Markdown Preview Plus. Что предлагает следующие функции.
1. Математические уравнения с использованием LaTeX:
Фактически вы можете вставить скрипты LaTeX между знаками доллара, и он будет отображаться как скрипт LaTeX и отображаться в предварительном просмотре с привязкой клавиш CTRL + SHITFT + X. Вам даже не обязательно знать весь LaTeX, достаточно нескольких фрагментов.
## Иллюстрирование LaTex___
$$ | \ Psi \ rangle = \ alpha | 0 \ rangle + \ beta | \ rangle $$
2. Подсветка синтаксиса
Вместо использования отступов для обозначения блоков кода вы можете использовать обратные кавычки, за которыми следует имя языков, на которых предположительно написан ваш скрипт. Языков, синтаксис которых поддерживается, слишком много, чтобы их перечислять здесь, но вот пример на python.
## Иллюстрирование выделения синтаксиса___
"питон
импортировать это
def my_function ():
print ("Привет, мир!")
возврат 0
"
Есть много вкусов или Markdown. У GitHub есть свой особый вкус и очень гибкий синтаксис. Это не должно запугивать пользователей, но предназначено для обслуживания более широкого круга из них. Это один из тех языков, в которых человек просто понимает нужное ему подмножество и использует его, вместо того чтобы беспокоиться о технических тонкостях (если вас не интересуют его технические особенности!)
