A Confluence é uma das wikis de equipe mais usadas, e muitas organizações têm bibliotecas de documentos do Word que pertencem à Confluence. Converter esses documentos de forma limpa é mais complicado do que parece Confluences Markdown suporte tem peculiaridades. Este guia mostra-lhe o mais confiável Word para Confluence fluxo de trabalho.
O Confluence suporta o Markdown?
Confluence tem suporte parcial Markdown, mas é dependente da implementação:
- Confluence Nuvem suporta a macro Markdown e pode render Markdown em certos contextos, mas o editor nativo é seu próprio formato
- Confluence Data Center / Servidor também tem uma macro Markdown
- Atlassian Rovo / Novo Editor versões mais recentes melhoraram Markdown
O método mais confiável em todas as versões é converter Word para Markdown com WordToMD, em seguida, colar o conteúdo Markdown usando Confluences Markdown importar recurso.
Método 1: Colar Markdown via Confluence Editor
Medidas
- Converter o seu documento Word em WordToMD e clique em Copia Markdown
- Em Confluence, abra o editor de página
- No menu Insertar (+ ícone), selecione Markup ou Outras Macros → Markup
- Escolha Markdown como idioma
- Colar o conteúdo Markdown
- Clique em Insertar
A macro Markup/Markdown apresenta o conteúdo como texto rico dentro da página. Ele não converte em blocos Confluence nativos, mas renderiza cabeçalhos, tabelas e listas corretamente.
Método 2: Word Importação de ficheiros
Confluence Cloud tem um recurso de importação Word:
- Criar uma nova página Confluence
- Clique no menu ... → Importar Word Documento
- Selecione o seu arquivo .docx
Isso funciona para documentos simples, mas tende a perder formatamento complexo. A rota Markdown dá mais controle.
Método 3: Converter para HTML
Algumas equipes preferem HTML como o formato intermediário porque o editor Confluences aceita HTML colar:
- Converter o seu Word doc para Markdown com WordToMD
- Converter o Markdown para HTML usando uma ferramenta on-line ou
markedlibrary - Mude para o Confluence Editor de Fonte (Ctrl+Shift+D ou da barra de ferramentas)
- Pegar o HTML
Esta abordagem preserva uma formatação mais complexa, mas tem mais etapas.
Compatibilidade de formatação
| Elementos | Markdown | Confluence Reprodução |
|---|---|---|
| Posições H1-H6 | ✅ | ✅ Renderiza corretamente |
| Em negrito / itálico | ✅ | ✅ Renderiza corretamente |
| Listas com indicadores | ✅ | ✅ Renderiza corretamente |
| Listas numeradas | ✅ | ✅ Renderiza corretamente |
| Tabelas | ✅ | ✅ Por meio da macro Markdown |
| Blocos de código | ✅ | ✅ Por meio da macro Markdown |
| Hiperligações | ✅ | ✅ Renderiza corretamente |
| Imagens | ️ Apenas URLs externos | ️ Anexos inline necessitam de upload manual |
Mesas de manuseio
Tabelas Word convertem-se em GFM através da sintaxe de tubos WordToMD. Confluence’s Markdown macro renders these correctly:
| Project | Owner | Status |
|---|---|---|
| Website redesign | Alice | In progress |
| API migration | Bob | Complete |Para operações de tabela mais complexas, ver Markdown Tabelas: um guia completo.
Blocos de código em Confluence
Confluence tem sua própria macro de Bloco de Código que oferece destaque de sintaxe e números de linha. Após a importação do conteúdo Markdown, você pode querer substituir blocos de código da macro Markdown por macros nativos do Bloco de Código de Confluência para melhor leitura:
- Editar a página
- Encontre a seção de código
- Inserir uma macro de bloco de código
- Configurar a linguagem para realçar a sintaxe
- Coloque o código
Referência: Markdown Guia de blocos de código para a sintaxe padrão.
Atlassian Confluence e ADF
Confluence Utilizações nativas na nuvem Formato de documento atlássico (ADF) um esquema JSON para conteúdo rico. A macro Markdown fica em cima disto. Para importações programáticas, o Confluence REST API aceita diretamente o ADF. Se você estiver construindo um pipeline automatizado, converta Word → Markdown → ADF usando as bibliotecas disponíveis.
Para a maioria das equipas, o fluxo de trabalho manual é mais simples e mais rápido.
Migração de uma biblioteca de documentos
Se estiver a migrar dezenas de documentos Word para Confluence:
- Converter todos os arquivos usando WordToMD (ou lote com Pandoc para grandes volumes)
- Crie um espaço Confluence e planeje a hierarquia da página
- Importação de páginas em secções, agrupamento de documentos relacionados em páginas-mãe
- Adicionar características específicas de Confluence após a importação: rótulos, restrições de página, @menções
FAQ
Posso usar Markdown nativamente em Confluence sem a macro?
Em algumas configurações de Confluence Cloud com o Novo Editor, você pode digitar atalhos de marcação e eles se convertem automaticamente (e.g., digitando ## cria um H2). Mas para colar documentos convertidos, a macro Markdown é mais confiável.
O meu formato de cabeçalho está perdido após a importação tudo parece texto de corpo. Isso geralmente significa que a macro Markdown não está ativa. O Markdown deve estar dentro de um bloco de macro Markup/Markdown, não colado como texto simples no editor padrão.
As tabelas mostram-se como caracteres de tubos brutos. O mesmo problema o conteúdo deve estar dentro de uma macro Markdown, não no editor de texto padrão.
Existe uma forma automatizada de sincronizar documentos Word com páginas Confluence? Sim ferramentas como o recurso Confluences Documentos Externos, Versões de rolagem, ou scripts personalizados usando o Confluence REST API pode sincronizar Markdown arquivos para páginas automaticamente.
Conclusão
O mais limpo . Word para Confluence fluxo de trabalho é: converter com WordToMD, em seguida, importa através da macro Markdown. Para documentos complexos ou migrações em massa, a abordagem intermediária HTML ou a automação REST API dá mais controle. De qualquer forma, o uso adequado dos estilos de cabeçalho Words antes da conversão garante que a hierarquia da página passe intacta.