Что такое Markdown

Простой способ оформлять текст.

Содержание
  1. Что это значит?
  2. Зачем это нужно?
  3. Примеры
  4. А это — третий
    1. Любимый четвертый уровень
      1. Жалкий пятый уровень
        1. Смешной шестой уровень
  5. Синтаксис
    1. Выделение текста
    2. Заголовки
    3. Ссылки
    4. Цитата
    5. Картинки
    6. Код
    7. Списки
  6. Дополнительно

Markdown — язык разметки текстов. Такие тексты легко писать и читать. Их можно без труда сконвертировать в HTML. Большинство программистов предпочитают Markdown для написания документации, описаний своих проектов, написания блогов и так далее.

Что это значит?

«Язык разметки» — это просто набор соглашений, правил.

Допустим, что вы общаетесь с другом по СМС. В них нельзя сделать текст жирным или наклонным. Вы договариваетесь с другом: если я пишу *что-то* вот так между звездочками, то считай, что это наклонный текст. А если я пишу **что-то** между двумя звездочками, то считай, что это жирный текст. Вы придумали правила.

Markdown — это набор подобных правил.

Правила понятны разным программам и сайтам. Например, «Вопросы и ответы» в уроках на Хекслете поддерживают Markdown. Это значит, что вы можете писать туда тексты по правилам Markdown, а после нажатия «Отправить» разметка станет реальной: текст в одинарных звездочках станет наклонным, текст в двойных звездочках станет жирным и так далее. Это конвертация из Markdown в HTML.

Зачем это нужно?

  1. Для добавления разметки туда, где невозможна реальная разметка. Например, в простом текстовом файле или в тех же СМС, где невозможно выделение жирным, создание заголовков, выделение цитат и пр.
  2. Для более удобного написания текстов для последующей конвертации в HTML или другие форматы.

Примеры


Я *считаю*, что это **хороший** пример. [Заходите на Хекслет](https://hexlet.io).
  

Я считаю, что это хороший пример. Заходите на Хекслет.


Что нужно знать:

* Git 
* JavaScript
  * ES6
  * Babel

В каком порядке изучать:

1. Английский язык 
1. Архитектура
  1. Компьютеры
  1. Операционные системы
  

Что нужно знать:

  • Git
  • JavaScript
    • ES6
    • Babel

В каком порядке изучать:

  1. Английский язык
  2. Архитектура
    1. Компьютеры
    2. Операционные системы

![Логотип Хекслета](https://i.imgur.com/8VvhUMB.jpg)
  

Логотип Хекслета


# Добро пожаловать!

А тут обычный текст.

## Это второй уровень

Хорошо быть заголовком.

### А это — третий
#### Любимый четвертый уровень
##### Жалкий пятый уровень
###### Смешной шестой уровень
  

Добро пожаловать!

А тут обычный текст.

Это второй уровень

Хорошо быть заголовком.

А это — третий

Любимый четвертый уровень

Жалкий пятый уровень
Смешной шестой уровень

Синтаксис

Это краткий справочник основных элементов синтаксиса Markdown. Единого стандарта не существует и разные версии Markdown могут отличаться в деталях. Но базовые элементы из списка ниже поддерживаются во всех стандартах.

Выделение текста

*Этот текст будет наклонным (курсив)*
_Этот текст будет наклонным (курсив)_

**Этот текст будет жирным**
__Этот текст будет жирным__

_Можно **вставлять** один тип в другой_

Заголовки

# Это самый крупный заголовок, он превращается в тег <h1>
## <h2>
### <h3>
#### <h4>
##### <h5>
###### <h6>

Ссылки

https://hexlet.io — текст простой ссылки станет кликабельной ссылкой автоматически

Ссылкой можно сделать любой текст:

[Это ссылка на Хекслет](https://hexlet.io)

Цитата

> Это мудрая цитата
> Мудрого человека.

Картинки

![Это опциональный alt-текст](http://i.imgur.com/HzsGS7G.png)

Код

Для выделения кода (или любого неотформатированного текста) используются специальные символы — обратные тики: `

Иногда нужно добавить кусок кода `function(12);` в обычную строчку текста.
А иногда нужно вставить целый блок кода:

```
const func = (num) => {  
  if (num > 0) {  
    return num - 1;  
  }
  return num + 1;  
};  
```

Списки

Непронумерованный список:

* Пункт 
* Еще один пункт
  * Подпункт
  * Еще один подпункт

Пронумерованный список:

1. Пункт 
1. Еще один пункт
  1. Подпункт
  1. Еще один подпункт

В пронумерованном списке можно использовать любые числа — это не важно. При конвертации в HTML или другой формат числа станут правильными и последовательными (1, 2, 3 и т.д.).

Дополнительно

  1. Markdown в Википедии
  2. 10-минутный интерактивный туториал

Рахим Давлеткалиев

Поделиться
Отправить