Стандартный Markdown
Markdown - это стандарт, разработанный Джоном Грубером. Основная цель Markdown - сделать файл возможным для чтения даже в чистом тексте. Если вы хотите посмотреть в текстовом редакторе, вам будет легко его читать. Это очень полезно для пользователей vim и подобных. Обратите внимание и помните, что это стандарт для изменения текстовых файлов. Это не заменяет HTML. Вместо этого вы используете его для создания HTML там, где это полезно. В случае с GitHub они отформатируют файл Readme на сайте. Если вы следуете стандарту, вы можете быть уверены, что он будет хорошо выглядеть.
Поскольку GitHub добавил всего несколько расширений, вам следует начать с использования шпаргалки по Markdown, а затем перейти к следующему. Вот список самых распространенных.
Уценка | Расширения | Результат |
# (1 на уровень) | Заголовки | |
* | Курсив | |
** | Смелый | |
> | Цитата | |
1. (так далее.) | Упорядоченный список | |
- | Неупорядоченный список | |
'код' | Ваш код | |
«' | Мкр-доб | Начало и завершение блока кода |
- | Горизонтальное правило | |
[Описание] (https: // www.пример.com) | Имя в квадрате и URL в обычных скобках | |
![замещающий текст] (изображение.png) | То же, ссылка на изображение | |
[1] | Мкр-доб | Сноска |
Списки можно вкладывать, делая отступы для любых элементов, которые вы хотите вложить.
Другие расширения для обычного Markdown, у вас есть расширения блоков кода, указанные выше. Они не всегда поддерживаются сервисами.
Уценка | Расширения | Результат |
### Заголовок # custom-id | Мкр-доб | Заголовок, к которому можно обратиться по его идентификатору |
термин: определение | Мкр-доб | Список терминов с определениями |
~ Ошибочный текст ~ | Мкр-доб | Зачеркнутый текст |
- [x] Задача, которую нужно выполнить | Мкр-доб | Список задач, который вы можете отметить |
Таблица очень простая, но для ее отображения вам понадобится несколько строк: Таблица:
| Имя | СТОИМОСТЬ || ----------- | ---------- |
| Коврики | 100 |
Расширения GitHub.
GitHub добавил несколько расширений, чтобы упростить обработку ссылок на других людей и проекты. Некоторые из них - это таблицы, упомянутые ранее. Больше всего вам поможет расширение автоматической ссылки. Он создает ссылку самостоятельно, когда вы используете ее на GitHub.
Остальные - это таблицы и элементы списка задач. Это удобно для отслеживания ваших задач в проектах. Последнее, о чем стоит упомянуть, - это расширение Disallowed Raw HTML. С помощью этого расширения некоторые теги фильтруются при рендеринге для HTML. Эти теги могут вызывать странные эффекты при рендеринге в GitHub.
Способы изучить GitHub Markdown
Если вас это сбивает с толку, вы также можете перейти на страницу GitHub и использовать встроенный редактор. Когда вы его используете, он автоматически завершает некоторые функции. Это работает только для проблем, но вы можете использовать его, чтобы выяснить некоторые вещи, смайлики появляются в виде списка, когда вы вводите двоеточие (:).
Вы также можете найти проект на GitHub с красивым файлом README и клонировать его на свой локальный диск. Оттуда вы можете изучить файл с помощью любого редактора, который пожелаете. Для крупных редакторов Emacs и Vim есть поддержка уценки с помощью расширений.
Если вы используете vim, вы можете добавить расширение подсветки синтаксиса с GitHub, vim-markdown. Это расширение показывает, что вы правильно написали код. Чтобы помочь вам увидеть, как это выглядит после завершения, вы также можете получить расширение Live Mark. Благодаря этому у вас может быть запущен веб-сервер, показывающий результат в реальном времени, когда вы вводите.
С Emacs у вас есть режим нетерпения, режим ожидания в реальном времени и предварительный просмотр в реальном времени. Все они показывают вашу полученную страницу в браузере, пока вы печатаете. Первый требует меньше библиотек, чем второй, но для запуска требуется дополнительный фрагмент кода.
Заключение
Несмотря на то, что уценка - это небольшая и намеренно простая спецификация, начало работы с ней может немного сбить с толку. Лучший способ научиться - использовать шпаргалку и написать свой документ Markdown. Вы можете обновить свой README.md на GitHub, и вы можете получить большую поддержку от встроенных функций ваших редакторов. Кстати, GitHub также поддерживает смайлы, которые вы можете добавить в свой документ. Вы можете использовать шпаргалку, чтобы узнать, какие они.
Скачать Markdown-CheatSheet здесь