Para impedir que o texto após um bloco de código Markdown seja interpretado como código, remova a tabulação inicial ou a indentação de quatro espaços. Se também quiser uma indentação visível no parágrafo no Obsidian do Mac, mantenha o Markdown sem indentação e aplique o espaçamento com CSS.

Por que o parágrafo vira outro bloco de código?

Fechar um bloco de código delimitado encerra esse bloco; não desativa a sintaxe de indentação para o texto abaixo. No nível superior, quatro ou mais espaços iniciais podem iniciar um bloco de código indentado separado. Portanto, o exemplo a seguir contém dois blocos de código, embora apenas o primeiro tenha delimitadores. CommonMark: blocos de código indentados.

```text
Sample output
```

    This should be a normal paragraph.

A distinção importante é se o texto indesejado pertence ao bloco delimitado original ou inicia um novo bloco. Se o delimitador de fechamento continuar visível dentro do código, verifique se ele usa o mesmo caractere do delimitador de abertura e contém pelo menos a mesma quantidade de crases ou tis. Para um bloco de nível superior, coloque os dois delimitadores na margem esquerda para facilitar a inspeção. GitHub Flavored Markdown: blocos de código delimitados.

Adicionar linhas em branco não neutraliza a indentação de quatro espaços. Por outro lado, o texto indentado que vem logo após um parágrafo comum pode continuar fazendo parte desse parágrafo, pois um bloco de código indentado não pode interrompê-lo. Isso explica por que uma indentação aparentemente semelhante às vezes se comporta de maneira diferente em outra parte de uma nota. CommonMark: blocos de código indentados.

Como restaurar um parágrafo comum no Mac?

No Obsidian, mude para o Modo de origem para inspecionar os delimitadores reais e os espaços em branco iniciais. Use o controle do modo de edição na barra de status ou escolha Configurações → Editor → Modo de edição padrão → Modo de origem. O Obsidian documenta que esse modo exibe a sintaxe Markdown exatamente como foi escrita. Visualizações e modo de edição.

Localize a primeira linha de texto após o delimitador de fechamento. Apague os espaços ou a tabulação iniciais, deixando o texto na margem esquerda. Repita para quaisquer parágrafos subsequentes com o mesmo problema. Preserve a indentação dentro do bloco de código pretendido.

Use este exemplo completo de Markdown como referência:

```text
Sample output
```

This is a normal paragraph with **bold text**.

This is another normal paragraph.

Mantenha a linha em branco após o delimitador de fechamento para facilitar a leitura do código-fonte. O GitHub recomenda explicitamente linhas em branco ao redor de blocos de código delimitados, embora a sintaxe dos delimitadores não as exija. Os delimitadores externos de quatro crases usados para exibir exemplos neste artigo permitem que as crases triplas internas permaneçam visíveis. Criar e destacar blocos de código.

Mude para a Visualização de leitura para inspecionar o resultado; no macOS, Cmd+E alterna entre edição e leitura. Confira se a explicação usa a formatação normal de parágrafo e se o texto em negrito aparece em negrito. A Visualização ao vivo oculta boa parte da sintaxe Markdown e a revela ao redor do cursor; por isso, use o Modo de origem para diagnosticar o problema e a Visualização de leitura para a conferência visual final. Visualizações e modo de edição.

Remover apenas dois espaços de uma indentação de quatro pode impedir a interpretação como código no nível superior, mas isso não cria uma indentação visível no parágrafo. O Obsidian documenta que espaços comuns adjacentes são unidos na renderização do texto. A indentação no código-fonte e a indentação exibida são requisitos diferentes. Sintaxe básica de formatação.

Como manter uma indentação visível no parágrafo no Obsidian?

Para indentar a primeira linha, use parágrafos comuns com um trecho de CSS. Isso separa a estrutura do parágrafo da apresentação: o Markdown continua legível, enquanto o CSS fornece o espaçamento visual. O Obsidian oferece suporte a trechos personalizados e a uma propriedade cssclasses para aplicar um estilo a notas selecionadas. Trechos de CSS.

O exemplo a seguir é um estilo personalizado ilustrativo, baseado no mecanismo de classes documentado pelo Obsidian e na indentação de parágrafos com CSS. Não é um comando de formatação integrado ao Obsidian. Ele se aplica aos elementos de parágrafo renderizados; confira a aparência na Visualização de leitura.

Adicionar a propriedade da nota e a folha de estilos

Coloque este bloco de propriedades no início da nota. Se ela já tiver um bloco de propriedades, adicione cssclasses ali em vez de criar um segundo bloco. Mantenha o texto após o delimitador do bloco de código sem indentação.

---
cssclasses:
  - paragraph-indent
---

Crie um arquivo de texto simples chamado paragraph-indent.css com esta folha de estilos completa:

.paragraph-indent p {
  text-indent: 2em;
}

O seletor p seleciona parágrafos dentro da classe personalizada da nota. A propriedade text-indent recua a primeira linha; as linhas seguintes permanecem na posição inicial normal. O valor 2em é apenas um exemplo e pode ser ajustado. Ele não insere espaços na nota. MDN: text-indent.

No Mac, use um editor de texto simples para a folha de estilos. Se usar o TextEdit, escolha Formatar → Converter em Texto Simples antes de salvar. Confirme que o nome final do arquivo é paragraph-indent.css, e não um documento de texto formatado ou um arquivo com a extensão .css.txt. A Apple documenta que a conversão para texto simples remove a formatação do documento e normalmente salva o arquivo com a extensão .txt. Criar, abrir e converter documentos no TextEdit no Mac.

  1. No Obsidian, abra Configurações → Aparência → Trechos de CSS.
  2. Selecione Abrir pasta de trechos e coloque paragraph-indent.css nessa pasta.
  3. Se o arquivo não aparecer na lista, selecione Recarregar trechos.
  4. Ative o botão do trecho e confira a nota na Visualização de leitura. Trechos de CSS.

Este exemplo abrangente indenta todos os parágrafos renderizados correspondentes dentro da nota selecionada, inclusive parágrafos em outras estruturas. Ele não limita o efeito ao parágrafo logo após um bloco de código. Para desfazer a formatação, desative o trecho ou remova a classe paragraph-indent da nota.

A folha de estilos não corrige o texto que ainda é interpretado como código: o seletor seleciona parágrafos. Corrija primeiro os espaços em branco. Além disso, esse seletor de parágrafo não é um estilo completo para o editor da Visualização ao vivo; não espere que a aparência no editor seja idêntica à da visualização de leitura.

O que muda dentro de uma lista ou no GitHub?

A indentação dentro de uma lista define a associação ao item da lista. Não a remova indiscriminadamente. Neste exemplo completo, o delimitador e a explicação têm três espaços iniciais, alinhando-os ao conteúdo após 1. . A explicação continua sendo um parágrafo dentro desse item. GitHub Flavored Markdown: itens de lista.

1. Review the sample.

   ```text
   Sample output
   ```

   This explanation belongs to the same list item.

Para outros marcadores de lista, calcule a indentação de continuação com base no marcador e no espaçamento que vem depois dele. Uma instrução genérica para remover toda a indentação quebraria a estrutura pretendida. Se a explicação deve ficar fora da lista, coloque-a de volta na margem esquerda. GitHub Flavored Markdown: itens de lista.

O Obsidian documenta o suporte a CommonMark e GitHub Flavored Markdown, além de suas próprias extensões. Isso não torna um trecho de CSS do Obsidian uma formatação Markdown portátil: o trecho é configurado separadamente no Obsidian. Ao mover uma nota, confira o renderizador do destino. O Obsidian também documenta que Markdown dentro de elementos HTML não é processado; portanto, um elemento HTML envolvente altera as condições de formatação em vez de oferecer uma solução universal. Markdown do Obsidian.

Qual correção você deve escolher?

Use a menor alteração que atenda ao resultado desejado:

  • Texto comum após o código: remova a tabulação ou a indentação de quatro espaços no início do parágrafo.
  • Um parágrafo dentro de um item de lista: mantenha a indentação necessária para o conteúdo desse item.
  • Uma indentação visível na primeira linha no Obsidian: use texto sem indentação com o exemplo de CSS aplicado à nota.
  • Um documento visualizado em vários aplicativos: mantenha a estrutura do Markdown clara e verifique a apresentação separadamente em cada destino.

Ao conferir a nota finalizada, pergunte-se: o texto é interpretado como parágrafo? Esse parágrafo tem o espaçamento desejado? Corrija primeiro a estrutura do Markdown. Em seguida, aplique a indentação visual onde o renderizador permitir, mantendo a folha de estilos separada do texto.

Fontes