Информация

Habr Flavored Markdown

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

Если вы не знакомы с Markdown, стоит взглянуть на основы markdown-разметки. 

Важно:

• На Хабре используется «Habr Flavored Markdown» (сокращенно HFM) — расширенная версия Markdown с добавлением специфических для Хабра элементов.

• Для некоторых элементов поддерживается разный синтаксис, но лучше использовать тот, который приведён ниже.

• В markdown-режиме нет меню для вставки блоков — все их предстоит добавлять вручную.

• Можно использовать некоторые HTML-конструкции, которых нет в разметке markdown.

• Не забывайте пользоваться функцией предпросмотра.

Синтаксис форматирования

• Жирный:

  **habr**

• Курсив:

  *habr*

• Подчёркнутый текст:

  <u>habr</u>

• Зачёркнутый текст:

  ~~habr~~

• Надстрочный текст:

  <sup>habr</sup>

• Подстрочный текст:

  <sub>habr</sub>

• Ссылка:

  [habr](https://habr.com)

  Важно: URL-адреса автоматически конвертируются в активные ссылки. Исключением являются ссылки внутри кода.

• Inline-код:

  `habr`

• Аббревиатура:

  <abbr title="Картинка для привлечения внимания">КДПВ</abbr>

Поддерживаемые строчные элементы:

• Inline-изображение:

  <img inline="true" src="https://habr.com" />

• Inline-формула (в Tex-формате):

  $inline$e=mc^2$inline$
  
  $e=mc^2$

Поддерживаемые блочные элементы:

• Заголовок:

  # Заголовок 1 уровня
  ## Заголовок 2 уровня
  ### Заголовок 3 уровня

  Важно: поддерживаются только заголовки уровня 1–3.

• Цитата:

  > Цитата

  Важно: вложенные цитаты не поддерживаются, внутри цитаты может быть только параграф текста, inline-изображение, inline-формула и все виды списков.

• Маркированные и нумерованные списки:

  - Пункт 1
  - Пункт 2
      - Вложенный пункт
  
  + Пункт 1
  + Пункт 2
      + Вложенный пункт
  
  * Пункт 1
  * Пункт 2
      * Вложенный пункт
    
  1. Пункт 1
  2. Пункт 2
      1. Вложенный пункт

  Важно: элементом списка может быть только параграф текста, при этом поддерживаются inline-изображения, inline-формулы и все виды вложенных списков.

• Медиаэлемент:

  <oembed>https://foo.bar</oembed>

• Изображение:

  ![alt](https://foo.bar "title")

• Таблица:

  | Заголовок 1 | Заголовок 2 |
  | --- | --- |
  | Ячейка 1 | Ячейка 2 |

• Блок кода:

  ```
  habr
  ```
  
  ```xml
  habr
  ```

  Поддерживаемые языки подсветки синтаксиса: 1c, assembly, bash, css, cmake, coffeescript, cpp (для C++), cs (для C#), dart, delphi, diff, django, elixir, erlang, fsharp (для F#), go, haskell, java, javascript, json, julia, kotlin, lisp, lua, markdown, matlab, nginx, objectivec, perl, pgSQL, php, powershell, python, r, ruby, rust, scala, smalltalk, sql, swift, typescript, vala, vbscript, vhdl, xml (для HTML и XML) и yaml.

• Формула (в Tex-формате):

  $$display$$e=mc^2$$display$$
  
  $$e=mc^2$$

• Спойлер (внутри спойлера может быть всё что угодно, включая другой спойлер):

  <spoiler title="Заголовок спойлера">
  
    Содержимое спойлера
  
  </spoiler>

  Важно: тег <spoiler> не входит в базовый синтаксис markdown, поэтому должен быть отбит пустыми строками от контента.

• Разделитель:

  ***
  
  ---

• Якорь:

  <anchor>habr</anchor>

• Персона:

  <persona>
  
    ![](https://bar.bar)
    ##### Имя
    Специальность
    
  </persona>

  Важно: <persona> должна быть отбита пустыми строками от контента

• Упоминание (меншен):

  @boomburum

Markdown-режим в комментариях

В форме комментариев также можно использовать markdown-разметку — для этого активируйте соответствующий чекбокс до начала ввода комментария.

При этом в комментариях не поддерживаются некоторые элементы, которые поддерживаются в публикациях: