Articles on my site have section-permalinks. Should your browser's "reading mode" implementation filter these out?
You can see them on article pages of I'll reply with a screenshot.

(note: I am not asking if *I* should keep them on my site; I'm only asking about reading-mode behavior)

@Seirdy, I would show that permalink everywhere.

I just had to enable desktop mode in Firefox Mobile and remove the "m." subdomain to get a section permalink from Wikipedia page. It's available only in the summary and only on desktop, and getting to it is painful on long articles.

On first thought, I would have moved the permalink before the title, but that makes it hidden from screen reader users that jump between headings. IMHO, your implementation seems just right.


IMHO, your implementation seems just right.

Thanks! I based my approach off of Amber Wilson’s section permalinks

One key difference: I wanted CSS to be an optional cosmetic enhancement, and not something that changes the content that people see (except for print media). I want my markup to only define structure/semantics, when possible (i.e. ideally no cosmetic div wrappers). That meant displaying the section permalink as a readable link. I used aria-labelledby to give each section permalink a unique accessible name.

I’ve heard positive feedback from both screen-reader and textual-browser users.

As for how this relates to reading mode implementations:

The point of reading-mode tools is to reduce clutter and focus on reading an article, without the author’s supplied user-interface. Section permalinks feel like a part of a “user interface” and should be removed; the interface should only be provided by the reading-mode. On the other hand, most reading modes don’t provide a document outline or a way to get a link to the current section, and users might want that functionality without having to leave reading-mode. On a third hand: if I include section permalinks in reading mode, then it’d end up looking almost identical to the un-distilled page. That’d make reading mode almost useless.

#POSSE note from

Sign in to participate in the conversation

The social network of the future: No ads, no corporate surveillance, ethical design, and decentralization! Own your data with Mastodon!