Material-UI Typography

Documentation and examples for Material-ui typography, including global settings, headings, body text, lists, and more.

Headings

Inside src/assets/theme/theme.js under the typography object, you will find all of the styles added to the Material-UI heading variants for the Typography component.

Here is how you should use them and how they look:

h1. Material-UI heading

h2. Material-UI heading

h3. Material-UI heading

h4. Material-UI heading

h5. Material-UI heading
h6. Material-UI heading
import React from "react";
// @material-ui/core components
import Typography from "@material-ui/core/Typography";
// @material-ui/icons components

export default function Example(){
  return (
    <>
      <Typography variant="h1">h1. Material-UI heading</Typography>
      <Typography variant="h2">h2. Material-UI heading</Typography>
      <Typography variant="h3">h3. Material-UI heading</Typography>
      <Typography variant="h4">h4. Material-UI heading</Typography>
      <Typography variant="h5">h5. Material-UI heading</Typography>
      <Typography variant="h6">h6. Material-UI heading</Typography>
    </>
  );
}

You can also add the component="h*" to also render the component as h* instead of a div. This is recommended if you want to have a powerful SEO website.

h1. Material-UI heading

h2. Material-UI heading

h3. Material-UI heading

h4. Material-UI heading

h5. Material-UI heading
h6. Material-UI heading
import React from "react";
// @material-ui/core components
import Typography from "@material-ui/core/Typography";
// @material-ui/icons components

export default function Example(){
  return (
    <>
      <Typography variant="h1" component="h1">h1. Material-UI heading</Typography>
      <Typography variant="h2" component="h2">h2. Material-UI heading</Typography>
      <Typography variant="h3" component="h3">h3. Material-UI heading</Typography>
      <Typography variant="h4" component="h4">h4. Material-UI heading</Typography>
      <Typography variant="h5" component="h5">h5. Material-UI heading</Typography>
      <Typography variant="h6" component="h6">h6. Material-UI heading</Typography>
    </>
  );
}

Customizing headings

Use the Box utility component to recreate small secondary text:

Fancy display heading With faded secondary text 

import React from "react";
// @material-ui/core components
import { useTheme } from "@material-ui/core/styles";
import Box from "@material-ui/core/Box";
import Typography from "@material-ui/core/Typography";
// @material-ui/icons components

export default function Example() {
  const theme = useTheme();
  return (
    <>
      <Typography variant="h3" component="h3">
        Fancy display heading{" "}
        <Box color={theme.palette.gray[600]} fontSize="80%" component="small">
          With faded secondary text
        </Box>
      </Typography>
    </>
  );
}

Display Headings

Traditional heading elements are designed to work best in the meat of your page content. When you need a heading to stand out, consider using a display heading—a larger, slightly more opinionated heading style.

Display 1
Display 2
Display 3
Display 4 
import React from "react";
// @material-ui/core components
import Box from "@material-ui/core/Box";
import Typography from "@material-ui/core/Typography";
// @material-ui/icons components

export default function Example() {
  return (
    <>
      <Typography variant="h1" component={Box} fontSize="3.3rem!important">
        Display 1
      </Typography>
      <Typography variant="h1" component={Box} fontSize="2.75rem!important">
        Display 2
      </Typography>
      <Typography variant="h1" component={Box} fontSize="2.1875rem!important">
        Display 3
      </Typography>
      <Typography variant="h1" component={Box} fontSize="1.6275rem!important">
        Display 4
      </Typography>
    </>
  );
}

Lead

Make a paragraph stand out by adding .lead.

Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus. 

import React from "react";
// @material-ui/core components
import Box from "@material-ui/core/Box";
// @material-ui/icons components

export default function Example() {
  return (
    <>
      <Box
        component="p"
        fontSize="1.25rem!important"
        fontWeight="300"
        lineHeight="1.7"
        marginTop="1.5rem"
      >
        Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
        Duis mollis, est non commodo luctus.
      </Box>
    </>
  );
}

Inline text elements

Styling for common inline HTML5 elements.

You can use the mark tag to highlight text.

This line of text is meant to be treated as deleted text.

This line of text is meant to be treated as no longer accurate.

This line of text is meant to be treated as an addition to the document.

This line of text will render as underlined

This line of text is meant to be treated as fine print.

This line rendered as bold text.

This line rendered as italicized text.

import React from "react";
// @material-ui/core components
// @material-ui/icons components

export default function Example() {
  return (
    <>
      <p>
        You can use the mark tag to <mark>highlight</mark> text.
      </p>
      <p>
        <del>This line of text is meant to be treated as deleted text.</del>
      </p>
      <p>
        <s>This line of text is meant to be treated as no longer accurate.</s>
      </p>
      <p>
        <ins>
          This line of text is meant to be treated as an addition to the
          document.
        </ins>
      </p>
      <p>
        <u>This line of text will render as underlined</u>
      </p>
      <p>
        <small>This line of text is meant to be treated as fine print.</small>
      </p>
      <p>
        <strong>This line rendered as bold text.</strong>
      </p>
      <p>
        <em>This line rendered as italicized text.</em>
      </p>
    </>
  );
}

While not shown above, feel free to use <b> and <i> in HTML5. <b> is meant to highlight words or phrases without conveying additional importance while <i> is mostly for voice, technical terms, etc.

Text utilities

Change text alignment, transform, style, weight, and color with the Box utilities component.

Blockquotes

For quoting blocks of content from another source within your document.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante. 

import React from "react";
// @material-ui/core components
import Box from "@material-ui/core/Box";
// @material-ui/icons components

export default function Example() {
  return (
    <>
      <Box component="blockquote" fontSize="1.25rem" marginBottom="1rem">
        <Box
          component="p"
          marginBottom="0"
          fontWeight="300"
          lineHeight="1.7"
          fontSize="1rem"
        >
          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer
          posuere erat a ante.
        </Box>
      </Box>
    </>
  );
}

Naming a source

Wrap the name of the source work in <cite>.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

Someone famous in Source Title 
import React from "react";
// @material-ui/core components
import { useTheme } from "@material-ui/core/styles";
import Box from "@material-ui/core/Box";
// @material-ui/icons components

export default function Example() {
  const theme = useTheme();
  return (
    <>
      <Box component="blockquote" fontSize="1.25rem" marginBottom="1rem">
        <Box
          component="p"
          marginBottom="0"
          fontWeight="300"
          lineHeight="1.7"
          fontSize="1rem"
        >
          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer
          posuere erat a ante.
        </Box>
        <Box
          component="footer"
          fontSize="80%"
          display="block"
          color={theme.palette.gray[600]}
        >
          — Someone famous in{" "}
          <Box component="cite" title="Source Title">
            Source Title
          </Box>
        </Box>
      </Box>
    </>
  );
}

Alignment

Use text utilities as needed to change the alignment of your blockquote.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

Someone famous in Source Title

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

Someone famous in Source Title 
import React from "react";
// @material-ui/core components
import { useTheme } from "@material-ui/core/styles";
import Box from "@material-ui/core/Box";
// @material-ui/icons components

export default function Example() {
  const theme = useTheme();
  return (
    <>
      <Box
        component="blockquote"
        fontSize="1.25rem"
        marginBottom="1rem"
        textAlign="center"
      >
        <Box
          component="p"
          marginBottom="0"
          fontWeight="300"
          lineHeight="1.7"
          fontSize="1rem"
        >
          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer
          posuere erat a ante.
        </Box>
        <Box
          component="footer"
          fontSize="80%"
          display="block"
          color={theme.palette.gray[600]}
        >
          — Someone famous in{" "}
          <Box component="cite" title="Source Title">
            Source Title
          </Box>
        </Box>
      </Box>
      <Box
        component="blockquote"
        fontSize="1.25rem"
        marginBottom="1rem"
        textAlign="right"
      >
        <Box
          component="p"
          marginBottom="0"
          fontWeight="300"
          lineHeight="1.7"
          fontSize="1rem"
        >
          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer
          posuere erat a ante.
        </Box>
        <Box
          component="footer"
          fontSize="80%"
          display="block"
          color={theme.palette.gray[600]}
        >
          — Someone famous in{" "}
          <Box component="cite" title="Source Title">
            Source Title
          </Box>
        </Box>
      </Box>
    </>
  );
}

Lists

Unstyled

Remove the default list-style and left margin on list items (immediate children only). This only applies to immediate children list items, meaning you will need to add the class for any nested lists as well.

  • Lorem ipsum dolor sit amet
  • Consectetur adipiscing elit
  • Integer molestie lorem at massa
  • Facilisis in pretium nisl aliquet
  • Nulla volutpat aliquam velit
    • Phasellus iaculis neque
    • Purus sodales ultricies
    • Vestibulum laoreet porttitor sem
    • Ac tristique libero volutpat at
  • Faucibus porta lacus fringilla vel
  • Aenean sit amet erat nunc
  • Eget porttitor lorem
import React from "react";
// @material-ui/core components
import { makeStyles } from "@material-ui/core/styles";
import Box from "@material-ui/core/Box";
// @material-ui/icons components

const useStyles = makeStyles({
  list: {
    listStyle: "none"
  }
})

export default function Example() {
  const classes = useStyles();
  return (
    <>
      <Box paddingLeft="0" marginBottom="1rem" marginTop="0" className={classes.list}>
        <li>Lorem ipsum dolor sit amet</li>
        <li>Consectetur adipiscing elit</li>
        <li>Integer molestie lorem at massa</li>
        <li>Facilisis in pretium nisl aliquet</li>
        <li>
          Nulla volutpat aliquam velit
          <ul>
            <li>Phasellus iaculis neque</li>
            <li>Purus sodales ultricies</li>
            <li>Vestibulum laoreet porttitor sem</li>
            <li>Ac tristique libero volutpat at</li>
          </ul>
        </li>
        <li>Faucibus porta lacus fringilla vel</li>
        <li>Aenean sit amet erat nunc</li>
        <li>Eget porttitor lorem</li>
      </Box>
    </>
  );
}

Inline

  • Lorem ipsum
  • Phasellus iaculis
  • Nulla volutpat
import React from "react";
// @material-ui/core components
import { makeStyles } from "@material-ui/core/styles";
import Box from "@material-ui/core/Box";
// @material-ui/icons components

const useStyles = makeStyles({
  list: {
    listStyle: "none",
  },
});

export default function Example() {
  const classes = useStyles();
  return (
    <>
      <Box
        paddingLeft="0"
        marginBottom="1rem"
        marginTop="0"
        className={classes.list}
      >
        <Box marginRight=".5rem" display="inline-block">
          Lorem ipsum
        </Box>
        <Box marginRight=".5rem" display="inline-block">
          Phasellus iaculis
        </Box>
        <Box marginRight=".5rem" display="inline-block">
          Nulla volutpat
        </Box>
      </Box>
    </>
  );
}

Description list alignment

Align terms and descriptions horizontally by using our grid system’s predefined classes (or semantic mixins).

Description lists
A description list is perfect for defining terms.
Euismod

Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.

Donec id elit non mi porta gravida at eget metus.

Malesuada porta
Etiam porta sem malesuada magna mollis euismod.
Truncated term is truncated
Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.
Nesting
Nested definition list
Aenean posuere, tortor sed cursus feugiat, nunc augue blandit nunc. 
import React from "react";
// @material-ui/core components
import { makeStyles } from "@material-ui/core/styles";
import Grid from "@material-ui/core/Grid";
// @material-ui/icons components

const useStyles = makeStyles({
  textTruncate: {
    overflow: "hidden",
    whiteSpace: "nowrap",
    textOverflow: "ellipsis",
  },
});

export default function Example() {
  const classes = useStyles();
  const truncatedClass = { root: classes.textTruncate };
  return (
    <>
      <Grid container component="dl">
        <Grid item component="dt" sm={3}>
          Description lists
        </Grid>
        <Grid item component="dd" sm={9}>
          A description list is perfect for defining terms.
        </Grid>
        <Grid item component="dt" sm={3}>
          Euismod
        </Grid>
        <Grid item component="dd" sm={9}>
          <p>
            Vestibulum id ligula porta felis euismod semper eget lacinia odio
            sem nec elit.
          </p>
          <p>Donec id elit non mi porta gravida at eget metus.</p>
        </Grid>
        <Grid item component="dt" sm={3}>
          Malesuada porta
        </Grid>
        <Grid item component="dd" sm={9}>
          Etiam porta sem malesuada magna mollis euismod.
        </Grid>
        <Grid
          item
          component="dt"
          sm={3}
          classes={truncatedClass}
        >
          Truncated term is truncated
        </Grid>
        <Grid item component="dd" sm={9}>
          Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum
          nibh, ut fermentum massa justo sit amet risus.
        </Grid>
        <Grid item component="dt" sm={3}>
          Nesting
        </Grid>
        <Grid item component="dd" sm={9}>
          <Grid container component="dl">
            <Grid item component="dt" sm={4}>
              Nested definition list
            </Grid>
            <Grid item component="dd" sm={8}>
              Aenean posuere, tortor sed cursus feugiat, nunc augue blandit
              nunc.
            </Grid>
          </Grid>
        </Grid>
      </Grid>
    </>
  );
}