MARKDOWN SYNTAX
Mark – сокращение от «marker» - разметка, Down – «низ», здесь используется в значении «облегчённый». И так «Синтаксис облегчённого языка разметки».
Markdown is a way to style text on the web. You control the display of the documents; formatting words as bold or italic, and creating lists are just a few of the things we can do with Markdown. Mostly Markdown is just regular text with a few non-alphabetic characters thrown in, like # (hash mark) or * (asterisk).
Мэркдаун - способ стилизации текста в Интернете. Вы контролируете отображение документов; форматирование слов, выделение жирным шрифтом или курсивом, создание списков - это лишь некоторые из вещей, которые мы можем сделать с Мэркдаун. В основном Markdown - это обычный текст с несколькими неалфавитными символами, например # (хэш знак) или * (звёздочка).
Раздел 1. HEADERS (Заголовки)
Для обозначения заголовков используется # хэш знак. Заголовки бывают 6 уровней.
Первый уровень один хэш знак, шестой шесть. Рассмотрим пример:
# Это заголовок 1 уровня
## Это заголовок 2 уровня
### Это заголовок 3 уровня
#### Это заголовок 4 уровня
##### Это заголовок 5 уровня
###### Это заголовок 6 уровня
Это заголовок 1 уровня
Это заголовок 2 уровня
Это заголовок 3 уровня
Это заголовок 4 уровня
Это заголовок 5 уровня
Это заголовок 6 уровня
Раздел 2. LISTS (Списки)
Unordered (Не упорядоченный)
* Вещь 1
* Вещь 2
* Вещь 2а
* Вещь 2б
- Вещь 1
- Вещь 2
- Вещь 2а
- Вещь 2б
Так же для подобной маркировки можно использовать + или -, результат тот же.
Ordered (Упорядоченный)
Для формирования нумерованных списков используются числа с точкой. Не важно какие цифры мы ставим, на выходе сформируется упорядоченный список, начинающийся с 1 (1,2,3...)
1. Вещь 1
1. Вещь 2
9. Вещь 3
- Вещь 1
- Вещь 2
- Вещь 3
Важно: если между строками вставить пустую строку нумерация начнётся сначала.
Раздел 3. IMAGES (Изображения)
![Landscape](https://i.lensdump.com/i/83mZv.jpg)
Немного о форматах файлов:
.jpg – самое обычное изображение, не поддерживает не заполненные цветом области, пример выше;
.png – поддерживает не заполненные цветом области;
![Dog](http://zoobosya.ru/image/cache/data-dog-75-150x150.png)
.gif – поддерживает не заполненные цветом области, поддерживает анимацию.
![Pokemon]( http://m.gifmania.ru/Animated-Gifs-Anime-Manga/Animations-Pokemon/Images-Ash-Brock-Misty/Ash-Brock-Misty-14748.gif)
Для хранения изображений используйте http://radikal.ru/, регистрация не требуется.
Создание красивых текстовых картинок http://online-letters.ru/
Раздел 4. EMPHASIS (Акцент, Особое внимание к тексту)
*Это курсив*
_Это также может быть курсивом_
Этот курсив
Этот также может быть курсивом
**Этот жирный текст**
__Этот также может быть жирным__
Этот жирный текст
Этот также может быть жирным
*Вы **можете** комбинировать их*
Вы можете комбинировать их
***Жирный курсив***
___Это тоже может бять жирным курсивом___
Жирный курсив
Это тоже может бять жирным курсивом
~~Зачёркнутый~~
Зачёркнутый
<sup>Надстрочный текст</sup>
Надстрочный текст
<sub>Подстрочный текст</sub>
Подстрочный текст
Повторение тэга умножает их:
<sup><sup><sup>Умноженный втрое надстрочный текст</sup></sup></sup>
Умноженный втрое надстрочный текст
<sub><sub><sub>Умноженный втрое подстрочный текст</sub></sub></sub>
Умноженный втрое подстрочный текст
Выравнивание текста
По левому краю
По центру
По правому краю
По ширине. Markdown is a way to style text on the web. You control the display of the documents; formatting words as bold or italic, and creating lists are just a few of the things we can do with Markdown. Mostly Markdown is just regular text with a few non-alphabetic characters thrown in, like # (hash mark) or * (asterisk).
<div class="pull-left">По левому краю</div>
<center>По центру</center>
<div class="pull-right">По правому краю</div>
<div class="text-justify">По ширине</div>
Горизонтальная линия:
___
Другое форматирование текста:
Разрыв строки <ol>Между тэгов добавляйте полезные вещи</ol>
Перенос <p>Между тэгов добавляйте полезные вещи</p>
Переход на новую строку <br>
Раздел 5. LINKS (Ссылки)
Автоматически созданная ссылка. Просто вставляете ссылку, и она уже является ссылкой:
https://golos.io/
Этот вариант создаёт ссылку, которая будет отображаться как введённый Вами текст:
[Golos.io](http://golos.io)
Изображение тоже может быть ссылкой:
[![](https://i.lensdump.com/i/83mZv.jpg)](https://i.lensdump.com/i/83mZv.jpg)
Раздел 6. BLOCKQOTES (Блок цитаты)
Мы используем > (greater than or close right angle bracket) знак больше или правую, закрытую угловую скобку. Чем больше этих знаков, тем выше уровень цитирования.
Как сказал Грейс Хоппер:
> Я всегда больше интересовался будущим, чем прошлым.
>> Прошлое никогда меня не интересовало.
>>> Особенно сейчас.
Как сказал Грейс Хоппер:
Я всегда больше интересовался будущим, чем прошлым.
Прошлое никогда меня не интересовало.
Особенно сейчас.
Раздел 7. BACKSLASH ESCAPES (Обратные слэши)
Markdown allows you to use backslash escapes to generate literal characters which would otherwise have special meaning in Markdown’s formatting syntax.
Мэркдаун позволяет использовать обратные слэши для генерации буквенных символов, которые в противном случае имели бы особое значение в синтаксисе форматирования Мэркдаун.
В общем, чтобы в тексте использовать символы, которые используются при разметке, ставим бэкслэш перед ними.
Markdown provides backslash escapes for the following characters:
Мэркдаун обеспечивает обратные слэши для следующих символов:
\ backslash (обратный слэш)
` backtick (кавычка)
* asterisk (звёздочка)
_ underscore (нижнее подчёркивание)
{} curly braces (фигурные скобки)
[] square brackets (квадратные скобки)
() parentheses (круглые скобки)
# hash mark (хэш знак)
+ plus sign (знак плюс)
- minus sign (hyphen) (знак минус (дефис))
. dot (точка)
! exclamation mark (восклицательный знак)
*Например звёздочки*
\*Например звёздочки\*
GITHUB FLAVORED MARKDOWN (Добавка к Мэркдаун от Гитхаб)
GitHub.com uses its own version of the Markdown syntax, GFM, that provides an additional set of useful features, many of which make it easier to work with content on GitHub.com.
ГитХаб.ком использует собственную версию синтаксиса Мэркдаун, ДжиЭфЭм, который предоставляет дополнительный набор полезных функций, многие из которых упрощают работу с контентом на ГитХаб.ком.
Раздел 8. USERNAME @MENTIONS (Имя пользователя, упоминания)
Typing an @ symbol, followed by a username, will notify that person to come and view the comment. This is called an “@mention”, because you’re mentioning the individual. You can also @mention teams within an organization.
Ввод символа @ (ат), за которым следует имя пользователя, уведомит этого человека, чтобы он пришел и просмотрел комментарий. Это называется «упоминание», потому что вы упоминаете человека. Вы также можете создавать команды упоминание внутри организации.
@arcange, @insider, @naminutku, @DR2073, @bender, @alternativamira, @eee, @radogost, @dreamer - пользователи с интересными материалами на Golos.io
@arcange, @insider, @naminutku, @DR2073, @bender, @alternativamira, @eee, @radogost, @dreamer - пользователи с интересными материалами на Golos.io
Раздел 9. FENCED CODE BLOCKS (Блокирование кода)
Markdown coverts text with ``` four leading spaces into a code block; with GFM you can wrap your code with ``` to create a code block without the leading spaces.
Мэркдаун скрывает текст с четырьмя ведущими пробелами в кодовый блок; с ДжиЭфЭм вы можете обернуть свой код , чтобы создать блок кода без ведущих пробелов.
function test() {
console.log("look ma’, no spaces");
}
Разделы ISSUE REFERENCES (Сноски) и TASK LISTS (Списки задач) оказались не функциональны.
Раздел 10. TABLES (Таблицы)
You can create tables by assembling a list of words and dividing them with hyphens - (for the first row), and then separating each column with a pipe | :
Вы можете создавать таблицы, собрав список слов и разделив их на дефисы - (для первой строки), а затем разделив каждый столбец на канал | :
Первый заголовок
Второй заголовок
Содержимое 1 ячейки
Содержимое 2 ячейки
Содержание 1 столбца
Содержание 2 столбца
Первый заголовок | Второй заголовок
------------ | -------------
Содержимое 1 ячейки | Содержимое 2 ячейки
Содержание 1 столбца | Содержание 2 столбца
Раздел 11. EMOJI (Смайлы)
To see a list of every image we support, check out https://www.webpagefx.com/tools/emoji-cheat-sheet/
Чтобы увидеть список всех поддерживаемых изображений, проверьте https://www.webpagefx.com/tools/emoji-cheat-sheet/
И ещё одна полезная ссылка: https://steemit.com/emojis/@blueorgy/steemit-emojis-master-list
😁 😅 😆 😘
😁 😅 😆 😘
Раздел 12. VIDEO (Видео)
Вставляем ссылку из YouTube и видео добавлено.
https://youtu.be/q_YN3M9Wdww
За время пока осваивал возможности Мэркдауна у меня вдруг перестало открываться окно редактирования поста. В тот момент я пытался добавить большой объём информации, что-то около 650 мб всяких мелких картинок. Проблема решилась очисткой кэша браузера.
Возможно администраторы в будущем решат эту проблему.
Если нужно, могу сделать подобный урок по Мэркдаун, но для тэгов html. На мой взгляд, во время редактирования удобнее именно html. Напишите в комментариях, если хотите урок по html для Golos.
У Вас есть что добавить, есть вопросы, пишите в комментарии, постараюсь ответить на все.
Пишите, что ещё Вы бы хотели увидеть в моих обзорах.
Понравилось - обязательно ставь upvote и подписывайся!
По завершению поста хочу выразить благодарность @acidsun, @on0tole из их постов, и в беседе с @anima была получена некоторая часть информации.
Основной источник информации: Руководство по стилизации Markdown.
Пост написал @shaytan91
Предыдущие посты серии:
01. Моя машина. Знакомство.
02. "Осенний трезвый слёт "Академии вольных путешествий".
03. Водитель без авто.
04. Автостопом на байкал. История одного водителя.
05. Очищение верой. Изгнание бесов. Ночь в часовне.
06. Дацан Гандан Жамба Лин.
07. 7 приложений для путешествий.
08. Монголия.
09. Здравствуй великий Китай.
10. Китай. Вагоны и маленькая тележка.
11. Китай. Фошань и ночь на участке полиции, Наньнин, Пинсьян.
12. Вьетнам. NGA - по-вьетнамски Россия.
13. Лоас - дикий, но в меру симпатичный.
14. Рама IX - король Адулятьед. Человек, изменивший жизнь очень многих, к лучшему, конечно!
15. Груди моей подруги. 18+
16. Тайланд. История 1: "Пожарный выход на 62 этаж".
17. Тайланд. История 2: "Деревянный член полиции".
18. Тайланд. История 3: "Пляж нудистов. Бездомные стерегут мой сон".
19. Собачий путь.
20. Тайланд. История 4: "1 бат за 1 литр".
21. Тайланд. История 5: "От мотополиции на ремонтном авто".
22. Тайланд. История 6: "Дворец Рамы IV. Пхукет. Заблудился ночью в лесу на новый год".
23. Тайланд. История 7: "В Малайзию! Тайские петухи на деревьях".
24. О поступках.
О путешественниках:
01. SHLOMO MAGEN. Путешественник из Израиля.
02. Аmanda Hainer. Путешественница из США.
03. Margaret Waterton. Учитель. Путешественница из Канады.
04. Никита Васильев. Чувашский путешественник.
05. Лидия Журавлёва. Хореограф, актриса, художник по танцам. Путешественница из Украины.
06. Александра Солнце. Место встречи Тайланд.
07. Дарья Кириллова. Возвращение домой.
Художественные рассказы:
01. Крошки.
02. "Не знаю". Откуда берутся дети.
03. Игры богов.
Другое:
01. Markdown - полное руководство. Текст и видео. Специально для Golos.io
Мои: Instagram YouTube
Привет! Я робот. Хозяин поручил мне проголосовать за Ваш пост! Я нашла похожий контент, который может быть интересен читателям ГОЛОСа:
https://guides.github.com/features/mastering-markdown/
Этот материал взят за основу информации для текста.
Можно ли сместить изображение относительно центра? Как это делается в Медиум.
Ну вы и придумали)) Markdown — этакая шутка над markup. А markup = разметка. Облегчённым markdown называют не вследствие названия, а из-за простоты синтаксиса.
А кашу из русского и английского в самой статье даже не комментирую…
Ваш пост поддержали следующие Инвесторы Сообщества "Добрый кит":
mishka, semasping, sterh, liseykina, magformers, chugoi, nerossoul
Поэтому я тоже проголосовал за него!
Узнать подробности о сообществе можно тут:
Разрешите представиться - Кит Добрый
Правила
Инструкция по внесению Инвестиционного взноса
Вы тоже можете стать Инвестором и поддержать проект!!!
Если Вы хотите отказаться от поддержки Доброго Кита, то ответьте на этот комментарий командой "!нехочу"
"В тот момент я пытался добавить большой объём информации, что-то около 650 мб всяких мелких картинок. Проблема решилась очисткой кэша браузера.
Возможно администраторы в будущем решат эту проблему."
@shaytan91, какие администраторы?
Проблема со стороны браузера??
@shenanigan, вероятно да и всё таки браузер выполняет код, если всё в нём работает как нужно, всё как нужно. Возможно вопрос не к разработчикам Golos, а к разработчикам Markdown.
@shaytan91 ты молодец. Вот бы еще тем добавить сюда, да? А то есть только 2: green и red. Ну это, конечно, вопрос к разработчикам.
@anima, работы с цветом нехватает. Даже в тексте, с его фоном...
Похоже на BB-codes для написания сообщений на форумах, и на HTML-коды для написания постов в ЖЖ.
@shafarevich, согласен, но BB-codes и HTML мне кажутся поудобнее, меньше вероятность того, что что-то не так пойдёт, что написал, то и работает или не работает :)
Просто, не в обиду разработчикам маркдауна, он "плодит сущности".
Мне тут в первый же день понадобилось выделить в посте курсивом несколько слов. Сделал как в ЖЖ, тегами в скобках - нифига не вышло. Полез в хелп смотреть - а тут звёздочками выделяется. Ну как всё это запомнить ?