Skip to content
Go back

LaTeX in blog posts (for market math when you need it)

Updated:  at  05:00 AM

Las Vegas & Sunstone — Published by Dr. Jan Duffy (Nevada license S.0197614.LLC, Berkshire Hathaway HomeServices Nevada Properties). Technical reference for Sunstone Las Vegas Homes. This is not tax or lending advice—consult licensed professionals for your situation.


This document shows how LaTeX can render in Markdown on AstroPaper when you need precise formulas (for example illustrating payment or rate relationships in educational posts). Use sparingly on real estate sites so mobile readers stay focused on homes and neighborhoods.

Free Close-up of complex equations on a chalkboard, showcasing chemistry and math symbols. Stock Photo
Photo by Vitaly Gariev

Table of contents

Open Table of contents

Instructions

In this section, you will find instructions on how to add support for LaTeX in your Markdown files for AstroPaper.

  1. Install the necessary remark and rehype plugins by running:

    pnpm install rehype-katex remark-math katex
  2. Update the Astro configuration (astro.config.ts) to use the these plugins:

    // other imports
    import remarkMath from "remark-math";
    import rehypeKatex from "rehype-katex";
    
    export default defineConfig({
      // other configs
      markdown: {
        remarkPlugins: [
          remarkMath, // <- new plugin
          remarkToc,
          [remarkCollapse, { test: "Table of contents" }],
        ],
        rehypePlugins: [rehypeKatex], // <- new plugin
        shikiConfig: {
          // For more themes, visit https://shiki.style/themes
          themes: { light: "min-light", dark: "night-owl" },
          wrap: true,
        },
      },
      // other configs
    });
  3. Import KaTeX CSS in the main layout file src/layouts/Layout.astro

    ---
    import { SITE } from "@config";
    
    // astro code
    ---
    
    <!doctype html>
    <!-- others... -->
    <script is:inline src="/toggle-theme.js"></script>
    
    <link
      rel="stylesheet"
      href="https://cdn.jsdelivr.net/npm/katex@0.15.2/dist/katex.min.css"
    />
    
    <body>
      <slot />
    </body>
  4. As the last step, add a text-color for katex in src/styles/typography.css.

    @plugin '@tailwindcss/typography';
    
    @layer base {
      /* other classes */
    
      /* Katex text color */
      .prose .katex-display {
        @apply text-foreground;
      }
    
      /* ===== Code Blocks & Syntax Highlighting ===== */
      /* other classes */
    }

And voilà, this setup allows you to write LaTeX equations in your Markdown files, which will be rendered properly when the site is built. Once you do it, the rest of the document will appear rendered correctly.


Inline Equations

Inline equations are written between single dollar signs $...$. Here are some examples:

  1. The famous mass-energy equivalence formula: $E = mc^2$
  2. The quadratic formula: $x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$
  3. Euler’s identity: $e^{i\pi} + 1 = 0$

Block Equations

For more complex equations or when you want the equation to be displayed on its own line, use double dollar signs $$...$$:

The Gaussian integral:

$$ \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} $$

The definition of the Riemann zeta function:

$$ \zeta(s) = \sum_{n=1}^{\infty} \frac{1}{n^s} $$

Maxwell’s equations in differential form:

$$
\begin{aligned}
\nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\
\nabla \cdot \mathbf{B} &= 0 \\
\nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\
\nabla \times \mathbf{B} &= \mu_0\left(\mathbf{J} + \varepsilon_0 \frac{\partial \mathbf{E}}{\partial t}\right)
\end{aligned}
$$

Using Mathematical Symbols

LaTeX provides a wide range of mathematical symbols:


Suggest Changes

Previous Post
How we configure this site (AstroPaper theme)
Next Post
Site update: Astro 4 and content slugs (AstroPaper v4)