Heading Structure Checker
Paste a page's HTML or Markdown and get its H1 to H6 outline with line numbers, plus checks for a missing H1, skipped levels and empty or duplicate headings.
Last checked
Page source
The tool cannot open a URL (there is no server), so paste the source. Open the page and press Ctrl+U (⌥+⌘+U on a Mac), then select all and copy.
If the page builds its content with JavaScript, copy the rendered page instead. Drag this button to your bookmarks bar, open the page and click the bookmark: Copy page HTML
Or paste copy(document.documentElement.outerHTML) into the DevTools console (F12) of that page; it copies the rendered HTML to your clipboard. Both run only on your own page and send nothing anywhere.
Outline
HTML: 12 headings, 7 things to check.
- Title
- Trail running shoes | Ridge Outfitters
- H1
- 1
- H2
- 6
- H3
- 3
- H4
- 2
- H5
- 0
- H6
- 0
- H2Ridge Outfittersimage alt only
- H2Menuduplicate
- H1Trail Running Shoes
- H2How to choose trail running shoes
- H4Lug depth & gripskips H3
- H4Drop and stack height
- H2Best sellers
- H3Ridge Glide 3
- H3(empty)empty
- H2Size guide
- H3Free returns within 60 days on every pair of trail running shoes we sellhidden: hidden attribute72 chars
- H2Menuduplicate
- OKOne H1: "Trail Running Shoes"
- CheckThe first heading is H2 (line 9), not the H1. Fine for a site header or nav heading; otherwise start the content with the H1.
- CheckSkipped 1 level: H2 → H4 (line 16). Go down one level at a time.
- Fix1 empty heading (line 20). Screen readers announce them as blank; remove them or add text.
- Check1 heading made only of an image (line 9). The alt text is the heading text, so make sure it reads as one.
- Check1 heading over 70 characters (line 23). Not an error; shorter headings are easier to scan.
- CheckDuplicate heading text: "Menu" ×2. Repeated headings are hard to tell apart in a screen reader's heading list.
- Check1 heading hidden (line 23). They are left out of the H1, skip and duplicate checks; make sure they show up when they should, for example inside tabs or menus.
How to use it
- Open the page in a browser, press Ctrl+U (Option+Command+U on a Mac) to see its source, select all and copy. If the page builds its content with JavaScript, click the Copy page HTML bookmarklet on that page, or run copy(document.documentElement.outerHTML) in the DevTools console.
- Paste it into the box. The tool detects HTML or Markdown; use the toggle if it guesses wrong, for example on a Markdown file that starts with raw HTML.
- Read the outline from top to bottom as a table of contents, then work through the checks. Click a line number to select that heading in the source.
- Copy the outline as text for a report or as Markdown headings to plan a rewrite, or download it as CSV for an audit sheet.
What it checks and why
Headings are the table of contents of a page. Screen reader users move through a page by its headings and often jump straight to the H1, so the WAI tutorials ask for headings that reflect the structure: one H1 for the main topic, H2 for the sections, H3 inside those, without skipping a level on the way down. Going back up, for example from H4 to H2 when a new section starts, is normal.
Search engines read headings too. Google's SEO starter guide suggests headings that help readers scan the page, and Google's John Mueller has said more than once that several H1s on a page are fine for Google Search. So this tool marks multiple H1s as a thing to check, not an error: the reason to keep one H1 is a clear outline for people, not a ranking rule. Skipped levels and empty headings matter for the same reason.
The checker reads the source the way a browser would without running it. It skips script, style, template and noscript blocks and comments, closes an unclosed heading where the HTML parser would, uses image alt text and SVG titles as heading text, follows aria-level and aria-label, and notes headings hidden with the hidden attribute, aria-hidden or an inline display: none. Hidden headings and headings with role="presentation" are not in the accessibility tree, so they stay in the outline but do not count for the H1, skip and duplicate checks. In Markdown it follows CommonMark: # to ###### headings, also inside block quotes and list items, text underlined with === or ---, and nothing inside fenced or indented code.
Specs and sources
Limits
- It cannot fetch a URL, because that would need a server. Paste the page source, or the rendered DOM for pages built with JavaScript.
- It reads markup, not styles from stylesheets: a heading hidden by a CSS class, or text that only looks like a heading, is not detected. Only inline style, hidden and aria-hidden count as hidden.
- Headings inside iframes, shadow DOM and template content are not part of the page outline here, and MDX components are not read. Raw HTML headings in Markdown are read only when the line starts with the <h1>–<h6> tag.
- Long and duplicate headings are hints, not errors. A repeated "Reviews" heading under two products can be right.
Questions
- What are header tags (H1 to H6)?
- Header tags is the common SEO name for the HTML heading elements <h1> to <h6>. H1 is the main heading of the page, H2 marks its sections and H3 to H6 the levels below. They are different from the <header> element, which wraps a page or section header such as the logo and navigation.
- Can a page have more than one H1?
- Yes. HTML allows it and Google has said several H1s do not hurt a page in Search. One H1 that names the page is still the clearest outline for screen reader users, so most pages are better with one.
- Is it bad to skip heading levels?
- Going down more than one level, such as H2 straight to H4, leaves a gap in the outline that screen reader users notice. It is not a ranking factor, but it is an accessibility issue the WAI tutorials ask you to avoid.
- Should the H1 be the same as the title tag?
- They can match, and often nearly do. The title tag is written for the search result and the browser tab, the H1 for the reader on the page, so a slightly longer or plainer H1 is fine.
- How do I check the headings on a website?
- Open the page, press Ctrl+U to view the source, copy it and paste it into this tool. For pages that render with JavaScript, use the Copy page HTML bookmarklet or run copy(document.documentElement.outerHTML) in the DevTools console, so you check what the visitor sees.
- Does the heading order matter for SEO?
- Google uses headings to understand what a section is about, but there is no bonus for a perfect H1 to H6 order. A clear order matters most for readers and assistive technology, and it usually makes the page easier to scan.
- Can I use a logo image as the H1?
- You can, and its alt text becomes the heading text. On most pages a text H1 that names the page topic is clearer than the site logo, which is the same on every page.