Справка по Markdown

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

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

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

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

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

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

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

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

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

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

Вот <span class="hi">[ссылка с неудачным названием](http://www.google.com/ "Google")</span>.
Не используйте "[«нажмите здесь»][^2]".
Посетите [][web].
  [^2]: http://www.w3.org/QA/Tips/noClickHere
        (Не используйте фразу «нажмите здесь»)
  [web]: https://rus.stackexchange.com/ "Русский язык"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

Rule #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 в цитату, просто добавьте символ > и пробел после него:

> Необязательно ставить > в начале пустых строк.
> Для Markdown не имеет значения, включена она или нет.
> 
> Но просто текст выглядит лучше
> пользователей, если вы введете дополнительный символ `>`
> между абзацами.

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

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

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

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

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

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

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

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

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

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

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

Эта страница содержит отметку о ![верном XHTML][].
 
[галочка]: http://w3.org/Icons/valid-xhtml10
             «Над чем ты смеёшься?»

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

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

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

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

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

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

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

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

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

    200 мл молока
    1 чайная ложка какао
    1 чайная ложка сахара

Первые четыре пробела будут удалены, но остальные сохранятся.

Alternatively, surround the text by three or more backticks or tildes:

```
 /\      o
/  \    -|-
|__|    / \
```

~~~
Answer!
   ^
   |
   +----- Question?
~~~

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

    Здесь будут *звёздочки*, а не курсив.

Используйте одиночные кавычки (`) для создания встраиваемой строки предварительно отформатированного текста:

Если в начале адресной строки вашего браузера указан протокол `https://`, соединение зашифровано.

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

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

Если вы не можете сделать что-то через Markdown, используйте 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>

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

Прочтите официальную справочную страницу по синтаксису Markdown.


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

В следующем разделе описаны некоторые дополнительные функции форматирования текста, которые не являются официальной частью Markdown.

Для обсуждения метки на данном сайте, , используйте

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

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

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

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

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

_курсив_ и **полужирный** шрифт, встраиваемый код в одиночных кавычках; и [основные ссылки](http://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], [answer] – ссылка на страницу «Как спрашивать» или «Как отвечать».

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

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

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

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

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