"Если" предполагает что я об этом всем в курсе

Вот это неочевидно, кстати )

Тут как хочешь, так и прочитаешь

Если для того чтобы как-то  - да, меня именно вот это всё запутало видимо

Александр, вам подойдёт такое решение?

Спросите ещё в @docsascode, может там кто-то делал это через pandoc или другой инструмент конкретно для Markdown.

Мне кажется, что апи конфлюенса позволяет засовывать в него HTML ( https://developer.atlassian.com/server/confluence/confluence-rest-api-examples/ ), а сделать HTML из маркдауна довольно просто. В итоге это на любом пайплайне должно делаться

HTML сойдёт, если не нужно вставлять специфические виджеты конфлюенса, вроде TOC, Children display, ссылок на джиру.
Так что всё сильно зависит от требований. А тем временем автор вопроса что-то не отвечает.

Интересна цель мероприятия всего этого, зачем дубликат всего в конфе еще нужен

Например:
— единое пространство поиска вместе с ещё кучей документации, которую пишут прямо в конфлюенсе
— дать доступ на чтение кому-то, у кого не должно быть доступа к репозиторию (например, потому что там ещё и код есть)
— есть упоротый стейкхолдер, который принципиально не будет читать что-то кроме конфлюенса
— есть контракт или требования сертификации, по которым доки должны быть в конфлюенсе

Справедливо

Да, примерно так - общее пространстов. Но есть одно требование, которое для нас очень болезненное. Документация архитектурная, разрабатывается решение под задачу, которая, например, состоит из 2-х этапов. Для первого разработали, зафиксировали версию, отдали на реализацию, на основании полученной документации начали разрабатывать доку для второй части. В процессе разработки 1-й части нашли ошибку, доку нужно править, но версия ее уже намного выше, чем была на старте разработки. Чтобы уйти от этого придумали, что будем вести доку в gitlab как проект - делаешь ветку под задачу (или ее этап) и работаешь в ней, если нужно, то вливаешь изменения из ветки-родителя. Но заказчика не устраивает gitlag - нужно чтобы все было в confluence. Договорились, что достаточно только мастер-ветки, которая будет содержать документацию по ПО в продуктовой среде.

Буду пробовать. Отпишусь по результату.

Там в docops еще варик с Фолиантом предложили, попробуйте сначала его

Спасибо! Посмотрю.

Благодарю всех за предложенные варианты!

Тот момент, когда мне проще интерфейс смотреть на английском. Прога называется Pulover Macro Creator. Прямо уж "ключевые государственные" )))

Для этого нужны gitlab CI и конвертировать маркдаун в html. Для массового импорта в конфлюэнс удобнее всего это делать через апи в виде xhtml. MVP можно за неделю сделать на коленке, а потом уже прикручивать фичи

Этот путь я сам пробовал, он рабочий и годный. Минусы: нужно писать код. Плюсы: раз уж пишешь код, можно сделать гибко

В @docsascode писали про готовые примеры с Foliant и md2conf

У него есть минус - это руби. Ну или плюс, для тех, кто его знает