Markdown to DOCX

1. Visão Geral

O componente Markdown to DOCX (md-to-docx) converte um texto em Markdown para um documento Word (.docx). Suporta títulos, negrito/itálico, listas, tabelas, links e outros elementos comuns de Markdown.

Use quando o fluxo precisa gerar um documento Word a partir de conteúdo escrito em Markdown — por exemplo, transformar um relatório gerado por um agente de IA em um arquivo .docx para download. Não use para converter documentos Word já existentes (esse é o caminho inverso).

2. Pré-requisitos

Não há credenciais externas. O componente grava arquivos temporários localmente no servidor onde a plataforma roda.

3. Autenticação e Conexão

Não aplicável.

4. Configuração / Operações Suportadas

O componente tem uma única operação: converter um texto Markdown em um arquivo DOCX.

Campo	Obrigatório	Tipo	Descrição	Exemplo
useFile	Não	Texto ("true"/"false")	Se false (padrão), o Markdown vem do campo markdown. Se true, vem de um arquivo já presente na mensagem.	"true"
markdown	Sim, se useFile for false	Texto	O conteúdo Markdown a converter.	"# Relatório\n\nConteúdo do relatório..."
file	Sim, se useFile for true	Texto	Nome da propriedade da mensagem onde está o arquivo Markdown.	"arquivoMarkdown"
outputFileName	Não	Texto	Nome do arquivo .docx gerado. Valor padrão: "document.docx".	"relatorio.docx"
charset	Não	Texto	Codificação de caracteres usada para ler o conteúdo. Valor padrão: "UTF-8".	"UTF-8"

O arquivo gerado é disponibilizado como uma propriedade na mensagem de saída, com o nome definido em outputFileName.

5. Exemplos Práticos

Exemplo simples: converter um texto Markdown simples em um documento Word.

Entrada:

{
  "relatorio": "# Relatório de Vendas\n\n**Total**: R$ 15.000\n\n- Produto A: 10 unidades\n- Produto B: 5 unidades"
}

Configuração do componente:

{
  "componentName": "md-to-docx",
  "configurations": {
    "markdown": "{$.body.relatorio}",
    "outputFileName": "relatorio-vendas.docx"
  }
}

Resposta (corpo da mensagem; o arquivo em si fica disponível como propriedade relatorio-vendas.docx para os próximos passos):

{
  "fileName": "relatorio-vendas.docx",
  "fileSize": 4820,
  "charset": "UTF-8",
  "markdownLength": 96
}

Exemplo avançado: converter um arquivo Markdown já recebido em um passo anterior (por exemplo, um upload), em vez de um texto direto.

Entrada (arquivo já anexado por um passo anterior):

{
  "arquivoMarkdown": "<arquivo .md, disponibilizado por um passo anterior>"
}

Configuração do componente:

{
  "componentName": "md-to-docx",
  "configurations": {
    "useFile": "true",
    "file": "arquivoMarkdown",
    "outputFileName": "documento-final.docx"
  }
}

Resposta:

{
  "fileName": "documento-final.docx",
  "fileSize": 12400,
  "charset": "UTF-8",
  "markdownLength": 2380
}

6. Erros Comuns e Troubleshooting

Erro / Sintoma	Causa provável	Como resolver
"Markdown content is empty"	O conteúdo Markdown resolvido está vazio.	Verificar se markdown ou o arquivo referenciado em file realmente têm conteúdo.
"file parameter is required when useFile=true"	useFile está ativado, mas file não foi preenchido.	Preencher file com o nome da propriedade que contém o arquivo.
"Markdown content not found. Use 'markdown' parameter (text) or set useFile=true with 'file' parameter."	Nem markdown nem file+useFile=true foram configurados corretamente.	Escolher uma das duas formas de fornecer o conteúdo e configurá-la corretamente.
"File [nome] not found inside the execution context."	O arquivo referenciado em file não existe na mensagem com esse nome.	Confirmar que um passo anterior disponibilizou o arquivo com esse nome exato.
"Error converting Markdown to DOCX: ..."	Falha durante a conversão (Markdown malformado ou erro interno).	Revisar o conteúdo Markdown de entrada.