Клавиатура разметки Jira онлайн: задачи и комментарии
Заголовки h1., жирный одной звёздочкой и ссылки, записанные наоборот.
Предпросмотр
Предпросмотр примерный: он показывает смысл разметки, а не то, как её нарисует конкретное приложение. Шрифты, цвета и отступы везде свои, а часть возможностей зависит от версии.
0 симв.
Что пишет каждая кнопка
| Действие | Синтаксис | Примечание |
|---|---|---|
| B | *bold* |
Жирный - одна звёздочка |
| I | _italic_ |
Курсив |
| S | -strikethrough- |
Зачёркнутый |
| U | +underline+ |
Подчёркнутый |
| Mono | {{monospace}} |
Моноширинный |
| Sup | ^superscript^ |
Верхний индекс |
| Sub | ~subscript~ |
Нижний индекс |
| h1. | h1. Heading |
Заголовок 1-го уровня |
| h2. | h2. Heading |
Заголовок 2-го уровня |
| bq. | bq. quoted line |
Цитата в одну строку |
| List | * item |
Маркированный список |
| # | # item |
Нумерованный список |
| Quote | {quote}text{quote} |
Блок цитаты |
| Code | {code:java}code{code} |
Блок кода с языком |
| No format | {noformat}text{noformat} |
Текст как есть, без разметки |
| Link | [text|https://example.com] |
Ссылка - сначала текст, потом вертикальная черта, потом адрес |
| Table | ||Header||Header||
|cell|cell| |
Таблица - двойные вертикальные черты для строки заголовков |
Телефон собирает файл приложения - поэтому это дольше обычной загрузки.
Ищите этот значок: Jira
Ссылка пишется наоборот
В Markdown текст ссылки стоит в квадратных скобках, а адрес в круглых. В Jira одна пара квадратных скобок с вертикальной чертой внутри, и текст идёт первым: [see the spec|https://example.com]. Кто переходит между ними, хоть раз ошибается, и в задаче остаётся строка скобок.
Где разметка всё ещё нужна
Новая Jira по умолчанию открывает визуальный редактор, и комментарий вручную можно писать без синтаксиса. Но в правилах автоматизации, шаблонах, задачах от скриптов и интеграций и при массовой правке панели инструментов нет, и там нужна разметка.
Она почти во всём не похожа на Markdown: жирный одной звёздочкой, подчёркнутый плюсами, моноширинный в двойных фигурных скобках, заголовки h1.-h6. В таблицах строку заголовков отделяют двойными чертами, а обычные строки одинарными.
Как пользоваться
- Напишите описание или комментарий здесь. Особенно если текст пойдёт в правило автоматизации или шаблон.
- Ставьте ссылки кнопкой. Кнопка ссылки вставит правильную форму, и черта окажется на своём месте.
- Укажите язык у блока кода. Включится подсветка, и стек вызовов станет читаемым.
- Скопируйте текст в Jira. Нажмите "Копировать всё" и вставьте в поле или правило.
Вопросы и ответы
В комментарии разметка видна символами. Почему?
Скорее всего, поле в визуальном режиме и вставленное понимает буквально. Переключите редактор в режим разметки.
Это то же, что разметка Confluence?
Близко: заголовки, выделение и блоки кода совпадают. В Confluence есть ещё макросы-панели info, note, warning и tip, которых в Jira нет.
Как показать разметку, чтобы она не сработала?
Используйте блок noformat: он выводит содержимое как есть. Так же удобно вставлять лог со скобками и чертами.
