---
title: Notes and other notation types · Cloudflare Style Guide
description: Use a warning to alert a reader to behavior that could impact the security of a users network or break functionality. You can call out product requirements, limitations, and specifications so that users see them loud and clearly.
lastUpdated: 2024-08-13T19:56:56.000Z
source_url:
  html: https://vale-updates2.preview.developers.cloudflare.com/style-guide/formatting/notes-and-other-notation-types/index.md
  md: https://vale-updates2.preview.developers.cloudflare.com/style-guide/formatting/notes-and-other-notation-types/
---

Use a **warning** to alert a reader to behavior that could impact the security of a users network or break functionality. You can call out product requirements, limitations, and specifications so that users see them loud and clearly.

Use a **note** to alert a reader to additional useful information that you cannot integrate into the text. You can provide context for a topic that would be a digression if added directly to the discussion at hand.

Refer to [notes/tips/warnings](https://developers.cloudflare.com/style-guide/documentation-content-strategy/component-attributes/notes-tips-warnings/) for details on the Markdown syntax.
