Клавиатура разметки Confluence онлайн: панели и макросы

Панели и макросы - то, что в Confluence ищут чаще всего.

Предпросмотр

Предпросмотр примерный: он показывает смысл разметки, а не то, как её нарисует конкретное приложение. Шрифты, цвета и отступы везде свои, а часть возможностей зависит от версии.

0 симв.
Что пишет каждая кнопка
Действие Синтаксис Примечание
B *bold* Жирный
I _italic_ Курсив
S -strikethrough- Зачёркнутый
Mono {{monospace}} Моноширинный
h1. h1. Heading Заголовок 1-го уровня
h2. h2. Heading Заголовок 2-го уровня
List * item Маркированный список
# # item Нумерованный список
Code {code:java}code{code} Блок кода
Quote {quote}text{quote} Блок цитаты
Info {info}text{info} Информационная панель
Note {note}text{note} Панель примечания
Warning {warning}text{warning} Панель предупреждения
Tip {tip}text{tip} Панель совета
TOC {toc} Оглавление, собранное из заголовков
Link [text|https://example.com] Ссылка - сначала текст

База знаний держится на панелях

Страницу корпоративной вики читают на бегу, в поисках одной нужной вещи. Помогают тут цветные плашки: это устарело, это требует согласования, это удалит данные. В Confluence это макросы, и набрать макрос быстрее, чем искать его в меню.

Разметка в визуальном редакторе

Облачный Confluence правит страницы визуально, и разметка в нём не способ хранения. Но она работает как быстрый ввод при наборе и встречается в шаблонах, параметрах макросов и тексте от скриптов и интеграций. Синтаксис общий с Jira: заголовки h1.-h6., жирный одной звёздочкой, ссылки с текстом до черты.

Своё у Confluence - панели и оглавление. Панель окрашивает блок текста по смыслу, а оглавление собирается из заголовков страницы само, и вести список вручную не нужно.

Как пользоваться

  1. Набросайте страницу здесь. Сначала структура: заголовки, панели, блоки кода.
  2. Предупреждения ставьте в панели, а не жирным. Цветную плашку заметят даже при беглом чтении.
  3. Скопируйте текст в Confluence. Нажмите "Копировать всё" и вставьте, или набирайте разметку прямо в редакторе.

Вопросы и ответы

При вставке разметка остаётся текстом. Почему?

Визуальный редактор считает вставленное текстом. Разметка срабатывает при наборе, а также в шаблонах и параметрах макросов.

Какую панель когда ставить?

Info для контекста, tip для совета, note для того, что стоит помнить, warning для всего, что может привести к потере данных или поломке.

Это то же, что разметка Jira?

Основа общая, а добавки разные: в Jira нет панелей, а в Confluence нет синтаксиса, связанного с задачами.