docs: admonitions right usage

[srini047]

Related Issues

• fixes Tip and Note tags malformed in Document Stores doc page #11059

Proposed Changes:

Currently across haystack docs website we have this syntax for admonitions:

:::<admonition_name> <abc>

From docusaurus 3.10 it isn't supported: https://docusaurus.io/blog/releases/3.10#strict-admonitions
Right syntax is:

:::<admonition_name>
<abc>

How did you test it?

Check places currently not rendered properly with the changes.

Notes for the reviewer

@anakin87 Please help with review of the update PR.

Checklist

• I have read the contributors guidelines and the code of conduct.
• I have updated the related issue with new insights and changes.
• I have added unit tests and updated the docstrings.
• I've used one of the conventional commit types for my PR title: fix:, feat:, build:, chore:, ci:, docs:, style:, refactor:, perf:, test: and added ! in case the PR includes breaking changes.
• I have documented my code.
• I have added a release note file, following the contributors guidelines.
• I have run pre-commit hooks and fixed any issue.

[vercel]

@srini047 is attempting to deploy a commit to the deepset Team on Vercel.

A member of the Team first needs to authorize it.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
haystack-docs	Ready	Preview, Comment	Apr 9, 2026 9:04am

[anakin87]

Looks good. Thank you!