Modos de leitura para estudar e apresentar Markdown

Quais modos de leitura existem

Os modos de leitura mudam a forma como o mesmo documento é consumido. O Sanctuary combina leitura padrão, foco, cards de estudo, estudo guiado e apresentação em slides para reaproveitar o mesmo Markdown em contextos diferentes.

Para que serve

O objetivo é adaptar o consumo do conteúdo ao contexto do usuário:

• foco para concentração na seção atual;
• guiada para reflexão estruturada por seção;
• slides para reapresentar o Markdown como material de exposição.

Como os modos se comportam

Os modos são controlados por um sistema centralizado de estado. A implementação deixa claro que alguns modos são mutuamente exclusivos, principalmente focus, cards, estudo guiado, presentation e editor.

Modo Foco

No modo foco, o documento é quebrado em blocos de seção e o bloco mais relevante para o viewport é destacado. O usuário também pode clicar em um bloco para fixar a atenção nele.

Valor principal:

• reduzir distração visual;
• reforçar leitura por unidade semântica;
• funcionar bem em documentos com seções grandes.

Evidências:

• src/components/reader/ReaderToolbar.astro expõe o botão de foco e o estado visual associado à toolbar.
• src/scripts/reader/reader-core.js alterna o modo foco, destaca o bloco ativo e sincroniza a navegação do Reader.

Cards de estudo

No layout de cards, cada seção relevante do documento vira uma ficha de estudo com resumo e contagem de palavras. O usuário pode filtrar cards anotados, abrir uma seção inteira em tela expandida e salvar notas locais por seção.

Valor principal:

• transformar leitura em revisão modular;
• registrar observações sem sair do documento;
• facilitar retomada de seções já estudadas.

Evidências:

• src/components/reader/ReaderCardsView.astro define a grade, os filtros e a interface expandida dos cards.
• src/scripts/reader/reader-cards.js gera os cards a partir das seções do documento e persiste as notas em localStorage.

Leitura guiada com estudo guiado

Na leitura guiada atual, o produto organiza cada seção em torno de três fases de reflexão: previsão, questionamento e conclusão. O usuário ativa o estudo guiado, responde aos prompts inline e acompanha o mapa geral da sessão no painel lateral.

Valor principal:

• transformar um documento estático em trilha de leitura;
• manter sensação de avanço por seção;
• apoiar estudo, revisão e fechamento de sessão no próprio Reader.

Evidências:

• src/components/reader/ReaderLensPanel.astro define o painel de estudo guiado, o registro e o mapa da sessão.
• src/scripts/reader/reader-lens.js controla ativação, fases, progresso e exportações do estudo guiado.
• src/scripts/reader/lens-cluster.js injeta os pontos de reflexão diretamente ao lado das seções.

Modo Apresentação

O modo apresentação converte o documento em slides a partir das seções reconhecidas pelo Reader, isto é, headings H2 e H3. Quando o documento não tem essas seções, a apresentação usa um fallback de slide único com o conteúdo inteiro.

Valor principal:

• reutilizar conteúdo de documentação como material de apresentação;
• permitir walkthrough de especificações e aulas sem recriar slides;
• transformar um documento linear em narrativa por seções.

Evidências:

• src/components/reader/ReaderPresentation.astro define a interface de apresentação e visão geral.
• src/scripts/reader/reader-core.js divide o documento em slides por seção e controla navegação, overview e atalhos de teclado.

O que esse recurso revela sobre o produto

Os modos de leitura mostram que o Sanctuary quer aumentar o valor do documento sem exigir mudanças no conteúdo. O mesmo Markdown pode ser lido, estudado em etapas ou apresentado publicamente.

Isso muda bastante a natureza do produto: ele deixa de ser um viewer e passa a ser um “adaptador de consumo” para conteúdo estruturado.

Limitações e comportamento implícito

• os modos exclusivos não foram pensados para coexistir;
• cards e estudo guiado dependem de uma boa estrutura por seções;
• apresentação depende de headings H2/H3 bem definidos para virar sequência de slides;
• foco, cards e estudo guiado fazem mais sentido em documentos longos e estruturados;
• o comportamento do produto é mais forte quando o Markdown já está organizado por seções.

Papel do recurso no produto

Este é o recurso que mais diferencia o Sanctuary de um leitor Markdown comum. Ele revela um objetivo claro: transformar leitura de Markdown em experiência orientada, progressiva e reaproveitável.