markdown-formatting git:20260214.87ff913A

Immutable. This exact content never changes and is served at /api/v1/blob/304af838068ef110.

---
description: Markdown link conventions and code formatting for docs, blog posts, and rule files
globs: **/*.md, **/*.mdc, **/*.mdx
alwaysApply: false
---

# Markdown Formatting

## Documentation Links

Link API concepts that have corresponding doc pages:

- **External doc links**: `[Union](https://dataclient.io/rest/api/Union)`
- **Internal doc links**: Use site paths like `[Controller](/docs/api/Controller)` or `[Entity](/rest/api/Entity)`
- **Package links**: `[@data-client/rest](www.npmjs.com/package/@data-client/rest)`

## Repository Links

- **PR links**: `[#1234](https://github.com/reactive/data-client/pull/1234)`
- **Commit links**: ``[`abc123`](https://github.com/reactive/data-client/commit/abc123)``

## Code References

- Use backticks for inline code: function names, class names, file paths, package names
- Use fenced code blocks with language tags for multi-line code examples