Important: this documentation is not applicable to your currently selected format **stories**!

#
amp-mathml

#### Description

Displays a MathML formula.

#### Required Scripts

<script async custom-element="amp-mathml" src="https://cdn.ampproject.org/v0/amp-mathml-1.0.js"></script>

#### Supported Layouts

## Usage

Renders a MathML formula in an iframe.

The example below displays the quadratic formula:

<amp-mathml layout="container" data-formula="\[x = {-b \pm \sqrt{b^2-4ac} \over 2a}.\]" > </amp-mathml>

The example below displays Cauchy's integral formula:

<amp-mathml layout="container" data-formula="\[f(a) = \frac{1}{2\pi i} \oint\frac{f(z)}{z-a}dz\]" > </amp-mathml>

The example below displays a double angle formula for cosines:

<amp-mathml layout="container" data-formula="$$ \cos(θ+φ)=\cos(θ)\cos(φ)−\sin(θ)\sin(φ) $$" > </amp-mathml>

### Inline formula

This is an example of a formula of `<amp-mathml layout="container" inline data-formula="`x`"></amp-mathml>`

, `<amp-mathml layout="container" inline data-formula="\(x = {-b \pm \sqrt{b^2-4ac} \over 2a}\)"></amp-mathml>`

placed inline in the middle of a block of text. `<amp-mathml layout="container" inline data-formula="\( \cos(θ+φ) \)"></amp-mathml>`

This shows how the formula will fit inside a block of text and can be styled with CSS.

### Standalone Use outside valid AMP documents

Bento allows you to use AMP components in non-AMP pages without needing to commit to fully valid AMP. You can take these components and place them in implementations with frameworks and CMSs that don't support AMP. Read more in our guide Use AMP components in non-AMP pages.

To find the standalone version of `amp-mathml`

, see ** bento-mathml**.

## Attributes

### data-formula (required)

Specifies the formula to render.

### inline (optional)

If specified, the component renders inline (`inline-block`

in CSS).

### title (optional)

Define a `title`

attribute for the component to propagate to the underlying `<iframe>`

element. The default value is `"MathML formula"`

.

## Validation

See amp-mathml rules in the AMP validator specification.

## Version Notes

The 1.0 version of amp-mathml will, by default, only render formulas when they are offscreen to avoid layout shifts that would negatively impact the Page Experience (PX). If a formula is onscreen, it will resize to its correct size dynamically when the user has scrolled the formula out of the viewport. When the component returns to the viewport, they formula should be rendered. For best experience, it is recommended to provide the dimensions of the formula using `height`

and `width`

attributes so formulas onscreen are rendered immediately without causing a layout shift.

You've read this document a dozen times but it doesn't really cover all of your questions? Maybe other people felt the same: reach out to them on Stack Overflow.

Go to Stack Overflow Found a bug or missing a feature?The AMP project strongly encourages your participation and contributions! We hope you'll become an ongoing participant in our open source community but we also welcome one-off contributions for the issues you're particularly passionate about.

Go to GitHub