Первый пост в базе знаний

Секреты красивой верстки и правила написания материалов

🔍 Архитектура тегов: Поисковые группы

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

⚙️ Вендор (Разработчик ПО): Указывает производителя программного продукта или экосистему, о которой идет речь в статье (например: 1С, Microsoft, Linux, Docker).
👥 Целевая аудитория (Роль): Определяет фокус и глубину подачи материала в зависимости от предполагаемого читателя публикации. Значения: Пользователь, Администратор, Программист.
🏷️ Тег-уточнение (Тематика): Конкретизирует предметную область, технические нюансы или затронутые модули (например: ЗУП, Ошибки сборки, Флекс-контейнеры, Резервное копирование).

1. Базовая типографика и умные символы

Этот абзац демонстрирует встроенную умную типографику Goldmark. Три точки автоматически превратятся в многоточие… Дефисы превратятся в среднее – или длинное — тире. Обычные кавычки “елочки” или „лапки“ будут оформлены по правилам языка.

А этот абзац стал мелким и серым благодаря встроенным атрибутам Goldmark прямо в Markdown!

[!Внимание] Эта плашка отобразится как стандартная цитата (Blockquote).

2. Расширенные инлайн-маркеры (Goldmark Extras)

Подсветка текста: Мы можем выделить маркером ключевые слова.
Вставки и удаления: Этот текст был добавлен только что, а этот ~~устарел и удален~~.
Математические индексы: Формула воды: H₂О. Порядковые числительные: 1^ое место или 5^ый элемент.
Клавиши клавиатуры: Для сохранения нажмите Ctrl + S

3. Списки и Чек-листы задач

Списки с визуальными Tailwind-классами

Вы можете стилизовать списки на лету, меняя отступы и маркеры:

Скорость: Hugo собирает страницы за миллисекунды.
Мощь: Goldmark парсит всё без тормозов.

1
2
3
- **Скорость:** Hugo собирает страницы за миллисекунды.
- **Мощь:** Goldmark парсит всё без тормозов.
{class="space-y-2 list-disc pl-5 text-emerald-800 font-medium"}

Интерактивный список задач (Task List)

Изучить основы синтаксиса Front Matter
Настроить конфигурацию Goldmark
Интегрировать кастомные шорткоды для верстки

4. Стилизация изображений на лету

Вместо громоздких HTML-тегов или шорткодов, Goldmark позволяет передавать Tailwind-классы прямо в круглых скобках картинки:

Картинка выше отцентрирована, имеет скругленные углы, тень и рамку.

5. Продвинутые таблицы с выравниванием

Таблицы поддерживают выравнивание колонок с помощью двоеточий (:---, :---:, ---:).

Функция / Элемент	Статус поддержки	Пример синтаксиса	Класс Tailwind
Markdown Attributes	✅ Да	`{class="..."}`	`.text-sm`
Goldmark Extras	✅ Да	`==выделение==`	`.prose-mark`
HTML вставки	⚠️ Нужен `unsafe`	`<div>...</div>`	Любой
Шорткоды	💎 Родная фича	`{{/* % шорткод % */}}`	Динамический

6. Подсветка синтаксиса кода

Встроен мощный подсвечиватель кода (Chroma). Указывайте язык после трех кавычек:

1&НаКлиенте
2Процедура Тест() Экспорт
3    Для х=1 По 4 Цикл
4    КонецЦикла
5КонецПроцедуры

7. Кастомные шорткоды

7.1 Изображение

Изображение базы знаний — Интерактивный пример (увеличивается по клику)

7.2 Источник и правообладатель

При подготовке публикации использовались официальные разъяснения ФНС России: nalog.gov.ru

7.3 Важное примечание

Рекомендация: Установите актуальные релизы типовых конфигураций 1С. Если вам нужна помощь с обновлением, доверьте эту задачу сертифицированным специалистам ООО «2А СОФТ».

7.4 Список

1С:Бухгалтерия
1C:Управление нашей фирмой
1C:ERP Управление предприятием
1С:Комплексная автоматизация
1C:Управление торговлей