+> > > I still don't think `rtl`/`ltr` is the right terminology here. I think
+> > > the "API" should say what you mean: the distinction being made is
+> > > "text first" vs. "link first", so, say that.
+> > >
+> > > As far as I understand it, RTL languages like Arabic typically write
+> > > text files "in logical order" (first letter is first in the bytestream)
+> > > and only apply RTL rendering on display, and IkiWiki will parse files
+> > > in logical order too; so if a link's text and destination are both
+> > > written in Arabic, in your proposed order (text before link), an
+> > > Arabic reader starting from the right would still see the text
+> > > before the link. So I don't think it would make sense to suggest that
+> > > one order was more appropriate for RTL languages than the other: if
+> > > it's "right" (for whatever opinion of "right") in English, then it's
+> > > "right" in Arabic too.
+> > >
+> > > (If the destination is written in Latin then it gets
+> > > more complicated, because the destination will be rendered LTR within an
+> > > otherwise RTL document. I think the order still works though.) --[[smcv]]
+