Perguntas Frequentes
Visão geral do capítulo
Este capítulo abrange perguntas frequentes e métodos de solução de problemas do plugin opencode-md-table-formatter, ajudando você a localizar e resolver rapidamente vários problemas encontrados durante o processo de formatação de tabelas.
Navegação de subpáginas
Perguntas Frequentes: O que fazer quando a tabela não é formatada
Apresenta abrangentemente problemas comuns e soluções no uso do plugin:
- Tabela não formatada: Verificar configuração, requisitos de versão, reiniciar OpenCode
- Estrutura de tabela inválida: Entender o significado do erro "invalid structure", aprender a sintaxe correta de tabelas
- Falha na formatação: Tratar erro "table formatting failed" e situações anormais
- Tipos de tabelas não suportados: Entender cenários de limitação como tabelas HTML, células multilinha, etc.
- Desalinhamento após formatação: Investigar problemas como modo de ocultação, células muito longas, código em linha, etc.
Sugestão de caminho de aprendizado
Recomenda-se consultar este capítulo ao encontrar problemas práticos após concluir Visão Geral de Recursos, ou usá-lo como manual de referência para solução de problemas.
Você pode aprender na seguinte ordem:
- Ao encontrar problemas: Primeiro localize o tipo de problema com base nos sintomas (tabela não formatada, mensagens de erro, etc.)
- Investigar passo a passo: Verifique um por um de acordo com a lista de verificação do guia de solução de problemas
- Entender profundamente: Leia Especificações de Tabelas e Princípio do Modo de Ocultação para entender detalhes técnicos
- Limitações conhecidas: Veja Limitações Conhecidas para entender os limites do plugin
Pré-requisitos
Antes de aprender este capítulo, recomenda-se concluir primeiro:
- ✅ Comece em 1 minuto: Instalação e Configuração - Entenda como instalar e configurar o plugin
- ✅ Visão Geral de Recursos: A Mágica da Formatação Automática - Entenda os recursos principais e princípios de funcionamento do plugin
Ao mesmo tempo, você deve ter:
- Familiaridade com a sintaxe básica de tabelas Markdown
- Entendimento do método de configuração de plugins do OpenCode (
opencode.jsonc)
Próximos passos
Após concluir este capítulo, você pode continuar aprendendo:
Conhecimento avançado:
- Especificações de Tabelas: Que tipo de tabelas podem ser formatadas - Domine os requisitos de estrutura de tabelas válidas
- Princípio do Modo de Ocultação: Por que o cálculo de largura é tão importante - Entenda o princípio de funcionamento do modo de ocultação do OpenCode
- Detalhes de Alinhamento: Alinhamento à esquerda, centralizado, alinhamento à direita - Domine a sintaxe e efeitos dos três métodos de alinhamento
Detalhes técnicos:
- Limitações Conhecidas: Onde estão os limites do plugin - Entenda as limitações conhecidas do plugin e cenários onde não se aplica
- Detalhes Técnicos: Mecanismo de Cache e Otimização de Desempenho - Entenda o mecanismo de cache interno e estratégias de otimização de desempenho do plugin