diff --git a/docs/financial/financialentities.md b/docs/financial/financialentities.md
index cc948bb83c6644aa83f16ff8be2b3c95b3929cd9..6873856af7fd08a06c35f76c42fb63b387a3995c 100644
--- a/docs/financial/financialentities.md
+++ b/docs/financial/financialentities.md
@@ -64,7 +64,10 @@ In an accounting system this might be called credit-matching.
 
 Each line item will have one or more financial items denoting payments made against it. On creation of the order there
 will be a financial item for each line item and an additional item for every fee amount. Where the preferred flow is used
-this item will have a status of 'Unpaid'. (Note that for historical reasons this may not always be true but it's the goal - [see](https://github.com/civicrm/civicrm-dev-docs/issues/712))
+this item will have a status of 'Unpaid'.
+
+!!! note
+    For historical reasons this may not always be true but [it's the goal](https://github.com/civicrm/civicrm-dev-docs/issues/712).
 
 When a payment is made it might either pay off the line items, or a specific line item, in full. In that case the line item
 status is updated to Paid and an EntityFinancialTrxn record is created in the civicrm_entity_financial_trxn table linking