With their late-2025 OS updates, now all labeled ”…OS26“, Apple added Markdown import and export to their Notes app. Their APIs already supported some of that in earlier releases actually. I’m still looking for the definite guide on what they claim to implement or conform to, but I already found out some of how they let authors extend the syntax at protocol MarkdownDecodableAttributedStringKey documentation: ^[text](attribute: value), i.e. a circumflex introducing a special kind of inline link like construct where the URL is replaced by colon-separated key value pairs.
1 Like
Interesting syntax. How are multiple attribute-value pairs separated, do you know? (I couldn’t see more examples in the docs.)
Multiple attribute value pairs are apparently to be separated by a comma.
Source code formatting in Swift and ObjectiveC in Xcode is handled by DocC which supports some special domain-specific conventions, which don’t break standard Markdown/Commonmark, as it should. More interestingly, its term list syntax simply build upon hyphen bullets and a colon:
- term: definition
- `dt`: `dd`
Its aside (or admonition) syntax likewise uses single-line quotation blocks with (predefined English-only?) keywords before a colon, which is slightly less bad than what Microsoft/Github introduced:
> tip: text
For local images, based on extensions after their name, some basic content negotiation is performed, e.g.  for name~dark@2x.png etc.
Its pipe table syntax supports alignment and row/column spanning.
| `th align=center` | `th colspan=2` ||
| :---: | --- | --- |
| `td rowspan=2` | `td` | `td`
^ | `th colspan=2` ||
from this page:
If this value is
NO, the Markdown parser supports only the CommonMark syntax. The default isNO.