Markdown é um formato de gravação. HTML é um formato de publicação. Assim, a sintaxe Markdown não é destinada a oferecer toda a versatilidade do HTML, apenas os elementos mais comuns para texto escrito. Quando precisar fazer algo mais complicado, use qualquer tag HTML inline e tags de nível de bloco que sejam compatíveis com DevSite em um arquivo Markdown. Não é necessário indicar que você está mudando de Markdown para HTML, basta usar a tag HTML como no exemplo abaixo.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
HTML inline
As tags HTML inline podem ser usadas em um parágrafo, item de lista ou cabeçalho de Markdown, e também podem conter sintaxe Markdown (por exemplo, **strong**, *emphasis* etc.) Isso é útil quando você quer chamar a atenção para um trecho de código, como no exemplo abaixo.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML no nível de bloqueio
As tags HTML no nível de bloco aceitas pelo DevSite precisam ser separadas do conteúdo ao redor com uma linha em branco. E, ao contrário das tags HTML inline, a sintaxe Markdown (por exemplo, **strong**, *emphasis* etc.) em tags HTML no nível de bloco não são renderizadas como no exemplo abaixo.
This is a Markdown paragraph that explains Java format strings:
// required blank line
<pre>
System.out.format("The square of *%d* is *%f*.*%n*", i, r);
</pre>
// required blank line
This is another Markdown paragraph.
Práticas recomendadas
Recomendamos formatar o HTML em arquivos Markdown das maneiras a seguir para evitar erros de renderização no DevSite.
Não use tags HTML no nível de bloqueio sem suporte O DevSite oferece suporte a várias tags HTML no nível de bloco. mas incluir um não compatível vai renderizar seu HTML como texto ou quebrar o código.
Não adicionar tabulações ou espaços extras ao recuar As tags de início e término no nível do bloco não devem ser recuadas com tabulações ou espaços. Alguns editores adicionam automaticamente guias ou espaços extras. Cuidado!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Não se esqueça de que o código sem recuo é relativo
Por exemplo, você não precisa recuar as tags de início e fim no nível do bloco ao criar listas no Markdown.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Não adicione uma linha em branco entre as tags de início e término
Isso é fácil de fazer ao alternar entre Markdown e HTML, mas uma simples linha em branco pode renderizar uma página de maneira incorreta com facilidade.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.