Документация Wiseo
Написание статей

Оформление и читаемость

Как использовать возможности редактора и не перегружать текст

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

Иерархия заголовков

Название статьи уже является главным заголовком страницы. В тексте используйте:

  • H2 — для основных разделов;
  • H3 — для подразделов внутри H2.

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

Выделение текста

В редакторе доступны жирное начертание, курсив, подчёркивание и зачёркивание.

  • Жирным выделяйте ключевой термин или короткий вывод.
  • Курсив подходит для смыслового акцента или названия.
  • Подчёркивание лучше оставить ссылкам: в обычном тексте его легко принять за ссылку.
  • Зачёркивание используйте, когда важно показать исправленное или утратившее силу значение.

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

Списки

Маркированный список подходит для равноправных пунктов, нумерованный — для шагов и порядка действий.

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

Цитаты

Оформляйте цитатой точные слова другого автора или короткое важное замечание. Укажите автора и дайте ссылку на первоисточник, когда он доступен.

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

Ссылки

Текст ссылки должен объяснять, куда она ведёт: «исследование доступности интерфейсов» полезнее, чем «читать здесь».

Перед публикацией проверьте, что ссылка:

  • открывает нужную страницу;
  • использует защищённый адрес https://, если он доступен;
  • ведёт на первоисточник, а не на пересказ;
  • не скрывает рекламный или партнёрский характер материала.

Таблицы

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

Если данные легче понять последовательным списком, выберите список.

Изображения и видео

Добавляйте медиа в том месте, где читателю нужен пример или подтверждение. Требования к форматам, обложке, подписям и источникам описаны в разделе «Обложка, изображения и видео».

Практика читаемого текста

  • Один абзац раскрывает одну мысль.
  • Первое предложение сообщает главное.
  • Термины объясняются при первом появлении.
  • Длинные предложения разделены там, где меняется мысль.
  • В подзаголовках нет точки в конце.
  • Эмодзи и прописные буквы не заменяют структуру.

Проверка оформления

Просмотрите статью по диагонали, читая только заголовок, лид и подзаголовки. Если по ним нельзя восстановить ход материала, уточните формулировки или перестройте разделы.

Содержание