Word к Confluence Markdown: Импортировать документы в вашу командную вики

Confluence - одна из наиболее широко используемых командных вики, и многие организации имеют библиотеки документов Word, которые принадлежат к Confluence. Преобразование этих документов чистым способом сложнее, чем кажется Confluences Markdown поддержка имеет свои причуды. Это руководство показывает вам наиболее надежные Word к Confluence рабочий процесс.

Поддерживает ли Confluence Markdown?

Confluence имеет частичную Markdown поддержку, но она зависит от реализации:

• Confluence Облако поддерживает макро Markdown и может отображать Markdown в определенных контекстах, но собственный редактор - это его собственный формат
• Confluence Центр данных / сервер также имеет макрос Markdown
• Atlassian Rovo / Новый редактор новые версии улучшили Markdown поддержку вставки

Наиболее надежный метод для всех версий - это преобразование Word в Markdown с WordToMD, затем вставьте содержимое Markdown с помощью функции импорта Confluences Markdown.

Метод 1: вставка Markdown через Confluence Editor

Шаги

1. Преобразовать ваш Word документ на WordToMD и нажмите Copy Markdown
2. В Confluence, открыть редактора страниц
3. В меню Вставить (+ иконка) выберите Означение или Другие макросы → Означение
4. Выберите Markdown в качестве языка
5. Вставить содержимое Markdown
6. Нажмите на вставку

Макро Markup/Markdown отображает содержимое в виде богатого текста на странице. Он не преобразует нативные Confluence блоки, но он правильно отображает заголовки, таблицы и списки.

Метод 2: Word Импорт файла

Confluence Cloud имеет функцию импорта Word:

1. Создать новую страницу Confluence
2. Нажмите в меню ... → Импорт Word документа
3. Выберите файл .docx

Это работает для простых документов, но, как правило, теряет сложную форматировку. Маршрут Markdown дает больше контроля.

Метод 3: преобразование в HTML

Некоторые команды предпочитают HTML в качестве промежуточного формата, потому что Confluences редактор принимает HTML вставку:

1. Преобразовать ваш Word doc в Markdown с WordToMD
2. Преобразовать Markdown в HTML с помощью онлайн-инструмента или marked library
3. Перейти на Confluence Source Editor (Ctrl+Shift+D или с панели инструментов)
4. Вставить HTML

Этот подход сохраняет более сложную форматировку, но имеет больше шагов.

Совместимость форматирования

Столы для обработки

Word таблицы конвертируются в GFM синтаксис трубки через WordToMD. Confluence’s Markdown macro renders these correctly:

| Project | Owner | Status |
|---|---|---|
| Website redesign | Alice | In progress |
| API migration | Bob | Complete |

Для более сложных операций таблицы см. Markdown Таблицы: полное руководство.

Блоки кода в Confluence

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

1. Редактировать страницу
2. Найти раздел кода
3. Вставить макрос блока кода
4. Настроить язык для подчеркивания синтаксиса
5. Вставить код

Ссылка: Markdown Руководство по блокам кода для стандартного синтаксиса.

Atlassian Confluence и ADF

Confluence Облако использует Формат атласского документа (ADF) схема JSON для богатого контента. Макро Markdown находится на вершине этого. Для программного импорта Confluence REST API принимает ADF непосредственно. Если вы создаете автоматизированную трубопровод, преобразуйте Word → Markdown → ADF с использованием доступных библиотек.

Для большинства команд ручной рабочий процесс проще и быстрее.

Перемещение библиотеки документов

Если вы перемещаете десятки Word документов на Confluence:

1. Преобразовать все файлы с помощью WordToMD (или партия с Pandoc для больших объемов)
2. Создать пространство Confluence и планировать иерархию страниц
3. Импортировать страницы в разделах, группировать связанные документы на родительских страницах
4. Добавить Confluence-специфические функции после импорта: ярлыки, ограничения страниц, @mentions

FAQ

Могу ли я использовать Markdown нативным образом в Confluence без макроса? В некоторых конфигурациях Confluence Cloud с Новым редактором, вы можете набирать Markdown-короткие пути, и они автоматически конвертируются (e.g., набирая ## создает H2). Но для вставки конвертированных документов макрос Markdown более надежный.

Форматирование заголовка потеряно после импорта все выглядит как текст. Обычно это означает, что макрос Markdown не активен. Markdown должен находиться внутри блока макросов Markup/Markdown, а не вставляться в стандартный редактор в виде простого текста.

Таблицы показывают как необработанные символы. То же самое содержимое должно быть внутри макроса Markdown, а не в стандартном текстовом редакторе.

Существует ли автоматизированный способ синхронизации документов Word с страницами Confluence? Да инструменты, такие как Confluences Функция внешних документов, Scroll Versions, или пользовательские скрипты с использованием Confluence REST API могут синхронизировать Markdown файлы с страницами автоматически.

Заключение

Самый чистый . Word к Confluence рабочий процесс: преобразовать с WordToMD, затем импортировать через макро Markdown. Для сложных документов или массовых миграций промежуточный подход HTML или автоматизация REST API дает больше контроля. В любом случае, правильное использование стилей заголовков Word перед конверсией гарантирует, что иерархия страниц будет сохранена.