Skip to content

Guide page renders the first H1 as a paragraph instead of the standard documentation header #69889

Description

@BHUVANSH855

Describe the problem that you experienced

On the following guide page:

https://angular.dev/guide/templates/ng-container

the page does not render the standard documentation header. Instead, the page starts with a paragraph containing the Markdown heading text.

The page currently renders:

<p># Grouping elements with ng-container</p>

instead of the expected documentation header that contains:

  • breadcrumbs
  • page title (<h1>)
  • edit button

As a result, the top section of the page appears broken while the rest of the guide renders normally.

Other guide pages continue to render the standard documentation header correctly. The issue appears to be specific to this page.


Enter the URL of the topic with the problem

https://angular.dev/guide/templates/ng-container


Describe what you were looking for in the documentation

I was reading the ng-container guide and expected the page to display the standard Angular documentation header with breadcrumbs and the page title before the guide content.


Describe the actions that led you to experience the problem

  1. Open https://angular.dev/guide/templates/ng-container.
  2. Observe the top of the page.
  3. The first heading is rendered as plain paragraph text instead of the standard documentation page header.

Describe what you want to experience that would fix the problem

The page should render the first Markdown heading as the standard documentation header, consistent with other Angular guide pages.

Expected structure:

<header class="docs-header">
  <docs-breadcrumb></docs-breadcrumb>
  <div class="docs-page-title">
    <h1>Grouping elements with ng-container</h1>
  </div>
</header>

Add a screenshot if that helps illustrate the problem

Image

The screenshot shows the page rendering the first heading as a paragraph instead of the standard documentation header.


If this problem caused an exception or error, please paste it here

No browser errors or exceptions were observed.


If the problem is browser-specific, please specify the device, OS, browser, and version

  • OS: Windows 10 Pro (64-bit)
  • Browser: Microsoft Edge
  • Version: 150.0.0.0

The issue was observed on the live angular.dev website.


Provide any additional information here in as much detail as you can

I verified that the corresponding Markdown source for this guide begins with a normal level-1 Markdown heading:

# Grouping elements with ng-container

I also reviewed the documentation generation pipeline in the repository. The Markdown file is passed directly to the Markdown parser without preprocessing, the registered walkTokens() hook only handles Mermaid code blocks, and the custom heading renderer generates the standard documentation header when it receives an H1 token.

Based on this investigation, I could not identify any code in the checked-in documentation pipeline that intentionally renders the first heading as a paragraph.

I was unable to complete a full local documentation build because an unrelated Bazel build failure occurred before the documentation generation tests executed, so this report is based on the behavior observed on the live site together with the repository investigation.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area: docs-infraAngular.dev application and infrastructuregemini-triagedLabel noting that an issue has been triaged by gemini

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions