Skip to main content

Справка по Markdown

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

Сделайте отступ в четыре пробела, чтобы создать изолированный блок <pre> <code>.

    printf("%d\n", 42);  /* напомните, о чём был вопрос
                            ? */

Вы также можете выделить текст и нажать CTRL+K чтобы выделить его как код или снять выделение.

Текст будет обёрнут тегами и отображён с использованием моноширинного шрифта. Первые четыре пробела будут обрезаны, но все остальные пробелы будут сохранены.

Markdown и HTML игнорируются внутри блока кода:

    <blink>
       Вам бы это не понравилось      , если бы оно не было в блоке кода.
    </blink>

Вместо использования отступов, вы также можете выделять код, обрамляя его тремя и более обратными кавычками или тильдами:

```
alert(false);
```

~~~
alert(true);
~~~

Чтобы набрать фрагмент кода внутри строки, используйте обратные кавычки:

Символ `$` — просто сокращение для `window.jQuery`.

(Обратная кавычка обычно находится слева вверху под клавишей Esc.)

Как и блоки кода, внутристрочные фрагменты кода будут отображаться с использованием моноширинного шрифта. Markdown и HTML не будут работать внутри них. Обратите внимание, что, в отличие от блоков кода, внутристрочные фрагменты кода требуют ручного экранирования любого HTML внутри них!

Если в самом коде находится обратная кавычка, вам придётся повторить её несколько раз в качестве разделителя:

Имя ``Tuple`2`` является действительным именем типа .NET.

Закончите строку 2 пробелами или добавьте разрыв строки <br/>:

Как сильно я тебя люблю?  
Не описать словами.
*Это набрано курсивом*, и _это_ тоже.
**Это набрано полужирным шрифтом**, и __это__ тоже.
Пользуйтесь ***курсивом и жирным шрифтом одновременно*** только если ___необходимо___.

Вы также можете выделить текст и нажать CTRL+I или CTRL+B чтобы переключить у текста наклонное или полужирное начертание соответственно.

Существуют три способа вставки ссылок. Последний читается сложнее всего:

Вот встраиваемая ссылка на [Google](https://www.google.com/).
Вот ссылка в виде сноски на [Google][1].
Вот легко читаемая ссылка на [Yahoo!][yahoo].

  [1]: https://www.google.com/
  [yahoo]: https://www.yahoo.com/

Вы также можете выделить текст и нажать CTRL+L чтобы сделать его ссылкой, или нажать CTRL+L при отсутствии выделенного текста для вставки ссылки в текущую позицию.

Определения ссылок могут появляться в любом месте документа — перед или после места, где вы их использовали. Идентификаторы определений ссылок [1] и [yahoo] могут быть любыми уникальными строками. Они нечувствительны к регистру, т.е. [yahoo]=[YAHOO].

Ссылки могут иметь атрибут заголовка, отображающийся при наведении. Атрибуты заголовка можно добавлять; они бывают полезными, если ссылка сама по себе недостаточно информативна и не сообщает пользователю о том, куда он будет перенаправлен.

Here's a <span class="bg-black-300">[poorly-named link](https://www.google.com/ "Google")</span>.
Не используйте "[«нажмите здесь»][^2]".
Посетите [][web].
  [^2]: https://www.w3.org/QA/Tips/noClickHere
        (Не используйте фразу «нажмите здесь»)
  [web]: https://ru.meta.stackoverflow.com/ "Stack Overflow на русском Meta"

Можно также использовать стандартный синтаксис HTML для гиперссылок.

<a href="https://example.com" title="пример">пример</a>

Мы изменили анализатор Markdown, и теперь он поддерживает чистые URL-адреса (в большинстве случаев, но не всегда — обращайте внимание на необычные символы в URL-адресах); они автоматически будут преобразованы в ссылки:

Я часто посещаю https://example.com.

Явно обозначайте URL-адреса, помещая их в угловые скобки:

Вы видели <https://example.com>?

URL-адреса могут быть либо относительными или абсолютными

Подчеркните текст, чтобы создать два заголовка верхнего уровня <h1> <h2> :

Заголовок 1
========
Заголовок 2
--------

Вы также можете выделить текст и нажать CTRL+H для переключения разных стилей заголовков.

Количество символов «=» или «-» не имеет значения; одного будет достаточно. Но при использовании большего числа знаков заголовки будет проще найти в основном тексте.

Используйте символ # для обозначения уровней заголовков:

# Заголовок 1 #
## Заголовок 2 ##
### Заголовок 3 ###

Закрывающие символы # не обязательны.

Горизонтальная линия <hr/> вставляется тремя или более дефисами, звёздочками или подчеркиваниями подряд:

---

Вы также можете нажать CTRL+R для вставки горизонтальной линии.

Правило № 1
---
Правило № 2
*******
Правило № 3
___

Также можно использовать пробелы между символами:

Правило № 4
- - - -

Вы также можете нажать CTRL+R для вставки горизонтальной линии.

Маркированный список <ul>:

- Используйте знак минуса для маркировки элементов
+ Или знак плюс
* Или звёздочку

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

1. Нумерованные списки просты
2. Markdown может отслеживать нумерацию списка
7. Таким образом, это будет элемент № 3.

Вы также можете выделить текст и нажать CTRL+U или CTRL+O чтобы сделать маркированный или нумерованный список соответственно.

Список с двойным междустрочным интервалом:

- Данный список окружен метками <p>.
 
- Итак, здесь будет дополнительный пробел между элементами

Для того чтобы поместить другой блок Markdown в список, просто сделайте отступ в четыре пробела для каждого уровня вложений:

1. Списки внутри элемента списка:
    - Отступ в четыре пробела.
        * отступ в восемь пробелов.
    - Снова четыре пробела.
1. Списки внутри элемента списка:
    - Отступ в четыре пробела.
        * отступ в восемь пробелов.
    - Снова четыре пробела.
2.  Несколько пунктов внутри списка:
    Лучше всего отделять абзацы четырьмя пробелами
    Можно оставлять и три, но это может вызвать
    проблемы при вложении других объектов
    Оставьте четыре.
 
    Мы добавили дополнительный пробел в первой строке для выравнивания
    его с этими параграфами.  В реальной ситуации мы можем
    применить ко всему списку для выравнивания всех элементов.
 
    Хотя данный параграф является частью одного из элементов списка, он слишком тяжёлый для пользователей. Возможно, будет лучше перенести вложенные параграфы вручную, как в случае с двумя предыдущими.
 
3. Цитаты внутри списка:
 
    > Пропустить строку и
    > сделайте отступ для знаков  > в четыре пробела.
 
4. Предварительно отформатированный текст в элементе списка:
 
        Пропустите строку и сделайте отступ в восемь пробелов.
        Для списка необходимо четыре пробела
        и четыре для выполнения блока кода.

Добавьте значок > в начало строки, чтобы создать цитату.

> Синтаксис основан на методе, используемом в работе почтовых программ.
> для оформления цитат. Вам не нужно создавать новую строку вручную
> параграфов в цитате, но если вы сделаете это, то они будут выглядеть намного лучше. Зависит от того, насколько вы ленивы.

Вы также можете выделить текст и нажать CTRL+Q чтобы поместить его в цитату или убрать цитирование.

Чтобы поместить другие блоки Markdown в цитату, просто добавьте символ > и пробел после него.

Чтобы поместить другие блоки Markdown в цитату, просто добавьте символ > и пробел после него:

> Символ `>` обязателен на пустых строках
> для создания единой цитаты.
> 
> Если убрать дополнительный символ `>`
> в итоге получится
> две отдельные цитаты.

Цитаты внутри цитаты:

> Стандартная цитата имеет отступ
> > Вложенная цитата имеет слишком большой отступ
> > > > Поддерживается вложенность любой глубины.

Списки внутри цитаты:

> - Список внутри цитаты
> - С символом &gt; и пробелом перед ним
>    * дополнительный список

Предварительно отформатированный текст в цитате:

>     Отступ в пять пробелов.  Первый
>     является частью указателя цитаты.

Изображения оформляются так же, как и ссылки, но перед ними стоит восклицательный знак:

![Верный XHTML](https://w3.org/Icons/valid-xhtml10).

Вы также можете нажать CTRL+G для вставки изображения.

Слово в квадратных скобках — это alt-текст, который будет отображаться в браузере, если он не может загрузить картинку. Не забудьте указать информативный alt-текст для программ, выполняющих чтение с экрана.

Как и ссылки, картинки поддерживают синтаксис сносок и заголовки:

Эта страница содержит отметку о ![верном XHTML][].

[галочка]: https://w3.org/Icons/valid-xhtml10
             «Над чем ты смеёшься?»

Внимание: Markdown не поддерживает сокращённый синтаксис для изображений:

Неправильное ![форматирование].

Однако вы можете использовать немного более расширенную версию скрытых имен ссылок:

Эта ![галочка][] работает.

Имя ссылки также используется как alt-текст.

Доступен стандартный синтаксис HTML для изображений, который позволяет менять ширину и высоту изображения.

<img src="https://example.com/sample.png" width="100" height="100">

URL-адреса могут быть либо относительными или абсолютными

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

 Чтобы перезагрузить компьютер, нажмите <kbd>ctrl</kbd>+<kbd>alt</kbd>+<kbd>del</kbd>.

Markdown не будет вносить изменения в HTML-код на уровне строк:

<b>Markdown здесь работает *нормально*.</b>

Блочные элементы HTML имеют несколько ограничений:

  1. Их следует отделить от окружающего текста пустыми строками.
  2. Начальные и конечные метки внешнего элемента блока не должны иметь отступов.
  3. Markdown нельзя использовать внутри блоков HTML-кода.
<pre>
    Здесь <em>нельзя</em> использовать Markdown.
</pre>

Нужна более подробная информация?

Посетите официальную страницу со спецификацией CommonMark.


Дополнения Stack Exchange

Последующие разделы описывают некоторые дополнительные возможности форматирования текста, которые не являются частью CommonMark.

Для обсуждения метки на сайте «Stack Overflow на русском Meta», , используйте

См. все вопросы с меткой [tag:слоны], чтобы узнать больше.

Метка будет автоматически связана с соответствующей метке страницей.

Для меток на Мете используйте следующий синтаксис:

Для этого есть метка [meta-tag:предложение].

Чтобы скрыть некоторую часть текста и сделать её видимой, только когда пользователь нажмёт на неё, используйте синтаксис цитирования с добавлением восклицательного знака:

В конце пятого эпизода выясняется, что >! он, действительно, его отец.

Для блоков кода будет использоваться подсветка синтаксиса с помощью highlight.js. Во многих случаях язык для подсветки синтаксиса автоматически определится на основе меток вопроса.

Чтобы вручную указать язык для блока кода, выделенного границами, добавьте язык в строку с открывающей границей:

``` lang-js
setTimeout(function () { alert("JavaScript"); }, 1000);
```

Вы можете использовать один из поддерживаемых кодов языка, например lang-cpp или lang-sql, либо указать метку, и тогда будет использоваться язык подсветки синтаксиса, связанный с этой меткой.

Чтобы указать язык подсветки синтаксиса для ВСЕХ следующих блоков кода используйте:

<!-- language-all: lang-html -->

Чтобы указать, что для данного блока кода не нужна подсветка синтаксиса, используйте:

<!-- language: lang-none -->

Поддержка таблиц у нас основана на спецификации расширенного синтаксиса таблиц GitHub-flavored markdown.

| Заголовок | Ещё заголовок  |
| --------- | -------------- |
| Первая    | строка         |
| Вторая    | строка         |

Выравнивание

Вы можете задать выравнивание столбца таблицы добавив : в соответствующую ячейку разделительной линии. Символ : слева сделает столбец выравненным влево (по умолчанию). Символ : справа сделает столбец выравненным вправо. Добавление : с двух сторон приведёт к выравниванию по центру.

| слева | по центру | справа |
|:----- |:---------:| ------:|
| Один  | Два       | Три    |

Подробнее о синтаксисе

  • Строка заголовка обязательна, и за ней должна следовать строка-разделитель с таким же количеством ячеек
  • Ячейки разделяются с помощью символа вертикальной черты (|)
  • Начальные и конечные вертикальные линии являются необязательными
  • Пробельные символы и - не нужно выравнивать визуально

Комментарии поддерживают только курсив, полужирный шрифт, код и несколько сокращений для ссылок.

_курсив_ и **полужирный** шрифт, встраиваемый код в одиночных кавычках; и [основные ссылки](https://example.com).

Поддерживаемые сокращения для ссылок:

  • [meta] – ссылка на Мету для текущего сайта; текст ссылки должен содержать имя сайта (например «Super User Meta»). Не работает, если у сайта нет Меты (или сайт сам является Метой).

  • [main] – как [Мета], только наоборот.

  • [edit] – ссылка на страницу редактирования сообщения, которому адресован комментарий, например /сообщения/{идентификатор}/правка. Текст ссылки «правка» (с учётом регистра).

  • [tag:tagname] и [meta-tag:tagname] — ссылка на страницу данной метки. Текст ссылки содержит имя метки. meta-tag работает только на Мете

  • [help], [help/on-topic], [help/dont-ask], [help/behavior] и [meta-help] – ссылка на часто посещаемые страницы Справочного Центра. Текст ссылки «Справка» (с учётом регистра). Все ссылки ведут на основной сайт.

  • [tour] – ссылка на страницу «Тур». Текст ссылки «тур» (с учётом регистра).

  • [so], [pt.so], [su], [sf], [metase], [a51], [se] – ссылка на заданный сайт. Текст ссылки содержит имя сайта.

  • [chat] – ссылка на чат данного сайта, текст ссылки — «Чат {имя сайта}».

  • [ask], [what you are asking], [answer] – ссылка на страницу «Как спрашивать» или «Как отвечать».

  • [code block] – ссылка на страницу справки по Markdown. Текст ссылки «блок кода».

  • [что-то.se] — ссылка на что-то.stackexchange.com, если сайт существует. Текст ссылки содержит имя сайта. Используйте [ubuntu.se] для Ask Ubuntu.

Автор сообщения всегда получает уведомление о вашем комментарии. Если вы отвечаете другому комментатору, укажите его имя там же:@peter и @PeterSmith уведомят предыдущего комментатора по имени “Peter Smith”.

Обычно достаточно упомянуть только имя участника, на чей комментарий вы отвечаете, например @ben или @marc. Однако иногда требуется уточнение: если ранее в комментариях участвовали три человека по имени Бен, необходимо добавить первый символ фамилии, например @benm или @benc . При ответе на комментарии пробелы в именах использовать нельзя, поэтому пишите не @peter smith, а @peters или @petersmith.

Если у участника, которому вы отвечаете, отсутствуют данные о его настоящем имени и фамилии, просто введите несколько символов его имени участника, чтобы было понятно, к кому вы обращаетесь. Минимально требуется 3 символа. Поэтому если вы отвечаете участнику DeathKnight666, введите @dea, @death или @deathknight.

Можно использовать данный метод для отправки уведомления любому редактору сообщения или, при необходимости, Мод модератору, закрывшему вопрос.