Escrita de fórmulas - Markdown e HTML

Escrita de fórmulas - Markdown e HTML

Escrever fórmulas é essencial para uma base de conhecimento ou documento técnico.



Tanto o Markdown como o HTML pretendem ser uma linguagem de marcação. Ou seja têm como objectivo apresentar um texto (ou outro objeto oou bloco) de forma formatada e legível ao utilizado.

Ambas se podem escrever em texto plano ou simples.


No que diz respeito à escrita de fórmulas que é o foco deste post, ambas permitem apresentar um resultado que satisfaz todas as necessidades.


Markdown

O Markdown, um formato de texto com marcações mais simples, usa a sintaxe do Latex. As fórmulas são escritas entre $$.

Pode usar editores online, o VS Code ou Obsidian entre outros.

No VS Code Shift + Ctrl + v permuta o modo de visualização e edição. O modo de edição, para a visualização no início deste post é a seguinte:

# Fórmula resolvente

$$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$


HTML

O HTML fica mais complicado para escrever, por isso é bom ter à mão um editor de código, VS Code ou outro, com capacidades de rever e completar a escrita.

O HTML usa o padrão Mathjx com recurso a uma biblioteca, para fórmulas muito complexas. No entanto para todos os casos com que me deparei a simples escrita nativa entre uma tag de <mathque usa o padrão Mathml é suficiente.

<math xmlns="http://w3.org" display="block">
  <mi>x</mi>
  <mo>=</mo>
  <mfrac>
    <mrow>
      <mo>&#x2212;</mo>
      <mi>b</mi>
      <mo>&#x2213;</mo>
      <msqrt>
        <mrow>
          <msup>
            <mi>b</mi>
            <mn>2</mn>
          </msup>
          <mo>&#x2212;</mo>
          <mn>4</mn>
          <mo>&#x2062;</mo>
          <mi>a</mi>
          <mo>&#x2062;</mo>
          <mi>c</mi>
        </mrow>
      </msqrt>
    </mrow>
    <mrow>
      <mn>2</mn>
      <mo>&#x2062;</mo>
      <mi>a</mi>
    </mrow>
  </mfrac>
</math>

portanto já aqui a complexidade é notória, se bem que escrever à mão a fórmula em Markdown também exige um bom conhecimento técnico.

O uso de uma IA resolve a complexidade.

O resultado renderizado com uma página de um navegador é o seguinte:


Isto poderia ser o suficiente, mas faltaria o bloco para o título, para igualar o apresentado no Markdown.

<h1>Fórmula resolvente</h1>


Este seria o código completo:

<!DOCTYPE html>
<html lang="pt">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Fórmula Resolvente em MathML</title>
</head>
<body>

    <h1>Fórmula resolvente</h1>

    <math xmlns="http://w3.org" display="block">
      <mi>x</mi>
      <mo>=</mo>
      <mfrac>
        <mrow>
          <mo>&#x2212;</mo>
          <mi>b</mi>
          <mo>&#x2213;</mo>
          <msqrt>
            <mrow>
              <msup>
                <mi>b</mi>
                <mn>2</mn>
              </msup>
              <mo>&#x2212;</mo>
              <mn>4</mn>
              <mo>&#x2062;</mo>
              <mi>a</mi>
              <mo>&#x2062;</mo>
              <mi>c</mi>
            </mrow>
          </msqrt>
        </mrow>
        <mrow>
          <mn>2</mn>
          <mo>&#x2062;</mo>
          <mi>a</mi>
        </mrow>
      </mfrac>
    </math>

</body>
</html>


Conclusão

Cabe a cada um ponderar o que mais lhe convém. Ter uma visão a mais longo prazo sobre a utilidade de um ou outro formato.



Comentários

Mensagens populares deste blogue

Linha do Oeste - Breve visita

Python - Excel Problemas e Vantagens

Politica de privacidade das aplicações colocadas na Play Store do Google