Шпаргалка по Markdown

Шпаргалка по Markdown.md

Markdown: шпаргалка NewScroll

Содержание

Заголовки

# H1
## H2
### H3
#### H4
##### H5
###### H6

Можно и так:

Alt-H1
======

Alt-H2
------

H1

H2

H3

H4

H5
H6

Можно и так:

Alt-H1

Alt-H2

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

Курсив — *звёздочками* или _подчёркиванием_.

Полужирный — **двойными звёздочками** или __двойным подчёркиванием__.

Комбинированное выделение — **звёздочки и _внутренний курсив_**.

Зачёркнутый текст — ~~вот так~~.

Курсив — звёздочками или подчёркиванием.

Полужирный — двойными звёздочками или двойным подчёркиванием.

Комбинированное выделение — звёздочки и внутренний курсив.

Зачёркнутый текст — ~~вот так~~.

Списки

1. Первый пункт
2. Второй пункт
   - Вложенный пункт
   - Ещё один вложенный пункт
3. Третий пункт

* Маркерный список
- Можно и так
+ И так тоже можно
  1. Первый пункт
  2. Второй пункт
  • Вложенный пункт

  • Ещё один вложенный пункт
    3. Третий пункт

  • Маркерный список

  • Можно и так

  • И так тоже можно

Ссылки

[Обычная ссылка](https://newscroll.ru)

[Ссылка с подсказкой](https://newscroll.ru "NewScroll")

[Ссылка по имени][newscroll]

[newscroll]: https://newscroll.ru

Обычная ссылка

Ссылка с подсказкой

Ссылка по имени

Изображения

![Логотип NewScroll](https://newscroll.ru/favicon.ico"Логотип NewScroll")

![Логотип NewScroll][logo]

[logo]: https://newscroll.ru/favicon.ico"Логотип NewScroll"

Логотип NewScroll

Логотип NewScroll

Код и подсветка синтаксиса

Блоки кода являются частью функций Markdown, но не подсветка синтаксиса. Однако многие обработчики, например Github поддерживают подсветку синтаксиса. .

`Код` в строке обрамляется `обратными апострофами`.

Код в строке обрамляется обратными апострофами.

Блоки кода выделяются либо тремя обратными апострофами ``` либо четырьмя пробелами в каждой строке. Рекомендуется использовать три апострофа -- они проще и только они поддерживают подсветку синтаксиса.

```javascript
var s = "Подсветка JavaScript";
alert(s);

```python
s = "Подсветка Python"
print s

```no-highlight
Язык не указан, синтаксис не подсвечен.
Но мы вставим в него <b>тег<b>.

var s = "Подсветка JavaScript";
alert(s);

s = "Подсветка Python"
print s

Язык не указан, синтаксис не подсвечен (некоторые обработчики все же подсвечивают).
Но мы вставим в него <b>тег</b>.

Таблицы

| Раздел | Что показывает | Пример |
|--------|----------------|--------|
| H1     | Главный заголовок | `#` |
| Код    | Подсветка синтаксиса | `python` |
| Ссылки | Переходы и упоминания | `https://newscroll.ru` |
Раздел Что показывает Пример
H1 Главный заголовок #
Код Подсветка синтаксиса python
Ссылки Переходы и упоминания https://newscroll.ru

Цитаты

> Markdown удобно использовать для заметок, статей и черновиков.
> Одна цитата может занимать несколько строк.

Markdown удобно использовать для заметок, статей и черновиков.
Одна цитата может занимать несколько строк.

Встроенный HTML

Иногда Markdown можно дополнять HTML-разметкой:

<dl>
  <dt>Markdown</dt>
  <dd>Удобный формат для статей и документации.</dd>

  <dt>NewScroll</dt>
  <dd>Пример сайта, где такой формат может быть особенно полезен.</dd>
</dl>
Markdown
Удобный формат для статей и документации.
NewScroll
Пример сайта, где такой формат может быть особенно полезен.

Горизонтальная линия

---

***

___

Перенос строки

Чтобы сделать новую строку внутри абзаца, обычно ставят два пробела в конце строки.

Первая строка.  
Вторая строка в том же абзаце.

Новый абзац создаётся двойным Enter.

Первая строка.
Вторая строка в том же абзаце.

Новый абзац создаётся двойным Enter.

Видео YouTube

Прямо встроить видео в чистом Markdown нельзя, но можно вставить картинку-ссылку:

[![Видео на YouTube](https://img.youtube.com/vi/ID_ВИДЕО/0.jpg)](https://www.youtube.com/watch?v=ID_ВИДЕО)

Итог

Markdown хорош тем, что позволяет быстро собирать чистый, понятный текст: статьи, заметки, FAQ, инструкции, кодовые блоки и даже аккуратные таблицы. Для редакции NewScroll это особенно удобно — меньше шума, больше структуры.