Modos de leitura: foco, cards, estudo guiado e slides em Markdown

O que é

Esta feature muda 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.

Objetivo no produto

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.

Arquitetura de produto observada

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 essa feature 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 da feature no produto

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