Mastodon Skip to content
  • Home
  • Aktuell
  • Tags
  • Über dieses Forum
Einklappen
Grafik mit zwei überlappenden Sprechblasen, eine grün und eine lila.
Abspeckgeflüster – Forum für Menschen mit Gewicht(ung)

Kostenlos. Werbefrei. Menschlich. Dein Abnehmforum.

  1. Home
  2. Uncategorized
  3. Hey blind people, what is the recommended accessible format for distributing text-only content?

Hey blind people, what is the recommended accessible format for distributing text-only content?

Geplant Angeheftet Gesperrt Verschoben Uncategorized
27 Beiträge 11 Kommentatoren 0 Aufrufe
  • Älteste zuerst
  • Neuste zuerst
  • Meiste Stimmen
Antworten
  • In einem neuen Thema antworten
Anmelden zum Antworten
Dieses Thema wurde gelöscht. Nur Nutzer mit entsprechenden Rechten können es sehen.
  • skye@toot.catS skye@toot.cat

    Hey blind people, what is the recommended accessible format for distributing text-only content? So that a short text of a couple hundred words is browsable, searchable and the structure is understandable?

    Am I correct is assuming that a well-structured PDF with all the titles set correctly would do the trick? Or is there some secret file format that is much better suited?

    The document is intended to be distributed as downloadable file, not as a website.

    (Sighted people feel free to boost but for the love of everything please do not try to answer)

    Edit: So what I have gathered

    • PDF actually a terrible option
    • HTML good, but not easily downloadable
    • Epub probably good, and easily downloadable
    • Markdown might be preferred for people that know how to work with them
    • Why the fuck is this still so difficult in the year 2026
    lunareclipse@snug.moeL This user is from outside of this forum
    lunareclipse@snug.moeL This user is from outside of this forum
    lunareclipse@snug.moe
    schrieb zuletzt editiert von
    #2

    @skye PDF loses absolutely all semantics, it essentially turns all your formatting into blocks of letters with a specific font, size and position, it only cares about the visual layout of the document.

    Using a screen reader on one, you'll at best get it to read line-by-line, but it will treat a line as a paragraph and make weird pauses and generally be a bad experience.

    You can make a standalone HTML file that people can open in their browser locally, as long as you don't put in any external resource references in it, HTML is great at conveying semantics if you use the correct tags.

    lunareclipse@snug.moeL lumi@heckin.howL 2 Antworten Letzte Antwort
    0
    • skye@toot.catS skye@toot.cat

      Hey blind people, what is the recommended accessible format for distributing text-only content? So that a short text of a couple hundred words is browsable, searchable and the structure is understandable?

      Am I correct is assuming that a well-structured PDF with all the titles set correctly would do the trick? Or is there some secret file format that is much better suited?

      The document is intended to be distributed as downloadable file, not as a website.

      (Sighted people feel free to boost but for the love of everything please do not try to answer)

      Edit: So what I have gathered

      • PDF actually a terrible option
      • HTML good, but not easily downloadable
      • Epub probably good, and easily downloadable
      • Markdown might be preferred for people that know how to work with them
      • Why the fuck is this still so difficult in the year 2026
      chaos@gts.schizofucked.monsterC This user is from outside of this forum
      chaos@gts.schizofucked.monsterC This user is from outside of this forum
      chaos@gts.schizofucked.monster
      schrieb zuletzt editiert von
      #3

      @skye personally we prefer markdown as even without a app that displays it properly its still parseable by ear if you have screenreader set to announce symbols and add newlines before and after headers

      pdfs have been iffy for us cause some pdf viewers do not expose anything to screenreaders, i think some versions of adobe acrobat work but sometimes apps just don't expose structure or even text when saving as pdf

      chaos@gts.schizofucked.monsterC 1 Antwort Letzte Antwort
      0
      • chaos@gts.schizofucked.monsterC chaos@gts.schizofucked.monster

        @skye personally we prefer markdown as even without a app that displays it properly its still parseable by ear if you have screenreader set to announce symbols and add newlines before and after headers

        pdfs have been iffy for us cause some pdf viewers do not expose anything to screenreaders, i think some versions of adobe acrobat work but sometimes apps just don't expose structure or even text when saving as pdf

        chaos@gts.schizofucked.monsterC This user is from outside of this forum
        chaos@gts.schizofucked.monsterC This user is from outside of this forum
        chaos@gts.schizofucked.monster
        schrieb zuletzt editiert von
        #4

        @skye partially sighted here, hope reply was okay, our eyes just flat out do not work a lot of the time nowadays, like rn

        skye@toot.catS 1 Antwort Letzte Antwort
        0
        • skye@toot.catS skye@toot.cat

          Hey blind people, what is the recommended accessible format for distributing text-only content? So that a short text of a couple hundred words is browsable, searchable and the structure is understandable?

          Am I correct is assuming that a well-structured PDF with all the titles set correctly would do the trick? Or is there some secret file format that is much better suited?

          The document is intended to be distributed as downloadable file, not as a website.

          (Sighted people feel free to boost but for the love of everything please do not try to answer)

          Edit: So what I have gathered

          • PDF actually a terrible option
          • HTML good, but not easily downloadable
          • Epub probably good, and easily downloadable
          • Markdown might be preferred for people that know how to work with them
          • Why the fuck is this still so difficult in the year 2026
          tonyamarie@chaosfem.twT This user is from outside of this forum
          tonyamarie@chaosfem.twT This user is from outside of this forum
          tonyamarie@chaosfem.tw
          schrieb zuletzt editiert von
          #5

          Tagging @Fragglemuppet

          @skye

          1 Antwort Letzte Antwort
          0
          • chaos@gts.schizofucked.monsterC chaos@gts.schizofucked.monster

            @skye partially sighted here, hope reply was okay, our eyes just flat out do not work a lot of the time nowadays, like rn

            skye@toot.catS This user is from outside of this forum
            skye@toot.catS This user is from outside of this forum
            skye@toot.cat
            schrieb zuletzt editiert von
            #6

            @chaos thank you!

            1 Antwort Letzte Antwort
            0
            • lunareclipse@snug.moeL lunareclipse@snug.moe

              @skye PDF loses absolutely all semantics, it essentially turns all your formatting into blocks of letters with a specific font, size and position, it only cares about the visual layout of the document.

              Using a screen reader on one, you'll at best get it to read line-by-line, but it will treat a line as a paragraph and make weird pauses and generally be a bad experience.

              You can make a standalone HTML file that people can open in their browser locally, as long as you don't put in any external resource references in it, HTML is great at conveying semantics if you use the correct tags.

              lunareclipse@snug.moeL This user is from outside of this forum
              lunareclipse@snug.moeL This user is from outside of this forum
              lunareclipse@snug.moe
              schrieb zuletzt editiert von
              #7

              @skye I've prepared a comparison with PDFs generated with pandoc vs the same content as HTML, need to edit the recordings a little though, but here are the files.

              I did notice that you can get somewhat more accessible PDFs with different Pandoc backends (like typst) though even then it only fixes headings.

              lunareclipse@snug.moeL 1 Antwort Letzte Antwort
              0
              • lunareclipse@snug.moeL lunareclipse@snug.moe

                @skye PDF loses absolutely all semantics, it essentially turns all your formatting into blocks of letters with a specific font, size and position, it only cares about the visual layout of the document.

                Using a screen reader on one, you'll at best get it to read line-by-line, but it will treat a line as a paragraph and make weird pauses and generally be a bad experience.

                You can make a standalone HTML file that people can open in their browser locally, as long as you don't put in any external resource references in it, HTML is great at conveying semantics if you use the correct tags.

                lumi@heckin.howL This user is from outside of this forum
                lumi@heckin.howL This user is from outside of this forum
                lumi@heckin.how
                schrieb zuletzt editiert von
                #8

                @lunareclipse @skye Possibly relevant: PDF is often absolute garbage at non-ASCII. Sometimes ç or ã render properly but the actual text generated is incorrect when one copies it, and for some reason "ti" becomes a theta on some documents. Everything about PDFs sucks. EPUBs are better for very long, book-styled documents, HTML is a better option regardless.

                1 Antwort Letzte Antwort
                0
                • skye@toot.catS skye@toot.cat

                  Hey blind people, what is the recommended accessible format for distributing text-only content? So that a short text of a couple hundred words is browsable, searchable and the structure is understandable?

                  Am I correct is assuming that a well-structured PDF with all the titles set correctly would do the trick? Or is there some secret file format that is much better suited?

                  The document is intended to be distributed as downloadable file, not as a website.

                  (Sighted people feel free to boost but for the love of everything please do not try to answer)

                  Edit: So what I have gathered

                  • PDF actually a terrible option
                  • HTML good, but not easily downloadable
                  • Epub probably good, and easily downloadable
                  • Markdown might be preferred for people that know how to work with them
                  • Why the fuck is this still so difficult in the year 2026
                  weirdwriter@caneandable.socialW This user is from outside of this forum
                  weirdwriter@caneandable.socialW This user is from outside of this forum
                  weirdwriter@caneandable.social
                  schrieb zuletzt editiert von
                  #9

                  @skye Markdown. Never do PDF ever. Saving it as HTML is best too since they can open local HTML files

                  skye@toot.catS fastfinge@fed.interfree.caF 2 Antworten Letzte Antwort
                  0
                  • weirdwriter@caneandable.socialW weirdwriter@caneandable.social

                    @skye Markdown. Never do PDF ever. Saving it as HTML is best too since they can open local HTML files

                    skye@toot.catS This user is from outside of this forum
                    skye@toot.catS This user is from outside of this forum
                    skye@toot.cat
                    schrieb zuletzt editiert von
                    #10

                    @WeirdWriter Thank you, this is helpful.

                    1 Antwort Letzte Antwort
                    0
                    • lunareclipse@snug.moeL lunareclipse@snug.moe

                      @skye I've prepared a comparison with PDFs generated with pandoc vs the same content as HTML, need to edit the recordings a little though, but here are the files.

                      I did notice that you can get somewhat more accessible PDFs with different Pandoc backends (like typst) though even then it only fixes headings.

                      lunareclipse@snug.moeL This user is from outside of this forum
                      lunareclipse@snug.moeL This user is from outside of this forum
                      lunareclipse@snug.moe
                      schrieb zuletzt editiert von
                      #11

                      @skye I made a video showing the difference with Orca, not that it's a great screen reader but it's good enough for a demonstration. Apparently my phone cannot record TalkBack's sound because google decided it's magically excluded so I only have what I got on desktop.

                      skye@toot.catS 1 Antwort Letzte Antwort
                      0
                      • lunareclipse@snug.moeL lunareclipse@snug.moe

                        @skye I made a video showing the difference with Orca, not that it's a great screen reader but it's good enough for a demonstration. Apparently my phone cannot record TalkBack's sound because google decided it's magically excluded so I only have what I got on desktop.

                        skye@toot.catS This user is from outside of this forum
                        skye@toot.catS This user is from outside of this forum
                        skye@toot.cat
                        schrieb zuletzt editiert von
                        #12

                        @lunareclipse Yeah, it's too bad that html is usually not accepted as a document type, I will need to see what I can do

                        skye@toot.catS 1 Antwort Letzte Antwort
                        0
                        • skye@toot.catS skye@toot.cat

                          @lunareclipse Yeah, it's too bad that html is usually not accepted as a document type, I will need to see what I can do

                          skye@toot.catS This user is from outside of this forum
                          skye@toot.catS This user is from outside of this forum
                          skye@toot.cat
                          schrieb zuletzt editiert von
                          #13

                          @lunareclipse It surprises me though, I would have thought that at some point in the last 25 years or so that pdf has been the default document type we would have managed to make them accessible…? Clearly I continue to be too optimistic about these things

                          cimb4@norden.socialC ppatel@mstdn.socialP 2 Antworten Letzte Antwort
                          0
                          • skye@toot.catS skye@toot.cat

                            Hey blind people, what is the recommended accessible format for distributing text-only content? So that a short text of a couple hundred words is browsable, searchable and the structure is understandable?

                            Am I correct is assuming that a well-structured PDF with all the titles set correctly would do the trick? Or is there some secret file format that is much better suited?

                            The document is intended to be distributed as downloadable file, not as a website.

                            (Sighted people feel free to boost but for the love of everything please do not try to answer)

                            Edit: So what I have gathered

                            • PDF actually a terrible option
                            • HTML good, but not easily downloadable
                            • Epub probably good, and easily downloadable
                            • Markdown might be preferred for people that know how to work with them
                            • Why the fuck is this still so difficult in the year 2026
                            freya@chaosfem.twF This user is from outside of this forum
                            freya@chaosfem.twF This user is from outside of this forum
                            freya@chaosfem.tw
                            schrieb zuletzt editiert von
                            #14

                            @skye honestly html file would work really well tbh

                            1 Antwort Letzte Antwort
                            0
                            • skye@toot.catS skye@toot.cat

                              Hey blind people, what is the recommended accessible format for distributing text-only content? So that a short text of a couple hundred words is browsable, searchable and the structure is understandable?

                              Am I correct is assuming that a well-structured PDF with all the titles set correctly would do the trick? Or is there some secret file format that is much better suited?

                              The document is intended to be distributed as downloadable file, not as a website.

                              (Sighted people feel free to boost but for the love of everything please do not try to answer)

                              Edit: So what I have gathered

                              • PDF actually a terrible option
                              • HTML good, but not easily downloadable
                              • Epub probably good, and easily downloadable
                              • Markdown might be preferred for people that know how to work with them
                              • Why the fuck is this still so difficult in the year 2026
                              freya@chaosfem.twF This user is from outside of this forum
                              freya@chaosfem.twF This user is from outside of this forum
                              freya@chaosfem.tw
                              schrieb zuletzt editiert von
                              #15

                              @skye as in a downlodable one in a zip file

                              1 Antwort Letzte Antwort
                              0
                              • skye@toot.catS skye@toot.cat

                                Hey blind people, what is the recommended accessible format for distributing text-only content? So that a short text of a couple hundred words is browsable, searchable and the structure is understandable?

                                Am I correct is assuming that a well-structured PDF with all the titles set correctly would do the trick? Or is there some secret file format that is much better suited?

                                The document is intended to be distributed as downloadable file, not as a website.

                                (Sighted people feel free to boost but for the love of everything please do not try to answer)

                                Edit: So what I have gathered

                                • PDF actually a terrible option
                                • HTML good, but not easily downloadable
                                • Epub probably good, and easily downloadable
                                • Markdown might be preferred for people that know how to work with them
                                • Why the fuck is this still so difficult in the year 2026
                                nicolai@babka.socialN This user is from outside of this forum
                                nicolai@babka.socialN This user is from outside of this forum
                                nicolai@babka.social
                                schrieb zuletzt editiert von
                                #16

                                @skye I am sighted but I used to work as an assistant for a blind student and specifically it was my job to convert text into something screen reader compatible/comfortable, so I think I can add a little bit:
                                Not all screen reader software is similarly capable. Also braille has no capital letters and some people use 8 (syllables) and 6 (letters) point braille, while some only 6 (letters) and others only text to speech.
                                PDF is a real surprise box of a format. You never know what it is really like. It is all but guaranteed that your PDF will handle semantics properly and that the different screen readers will do the same. Avoid it whenever you can.
                                Simpler formats are much better. Plaintext, RTF, Markdown, HTML (only text and lists, no tables, with semantic formatting).
                                Remember that tables work barely or not at all and less but consistent semantic formatting is more. (Sub)chapter titles are good. Many screen readers allow jumping between them, useful. Braille is slower to read than black print

                                nicolai@babka.socialN 1 Antwort Letzte Antwort
                                0
                                • skye@toot.catS skye@toot.cat

                                  Hey blind people, what is the recommended accessible format for distributing text-only content? So that a short text of a couple hundred words is browsable, searchable and the structure is understandable?

                                  Am I correct is assuming that a well-structured PDF with all the titles set correctly would do the trick? Or is there some secret file format that is much better suited?

                                  The document is intended to be distributed as downloadable file, not as a website.

                                  (Sighted people feel free to boost but for the love of everything please do not try to answer)

                                  Edit: So what I have gathered

                                  • PDF actually a terrible option
                                  • HTML good, but not easily downloadable
                                  • Epub probably good, and easily downloadable
                                  • Markdown might be preferred for people that know how to work with them
                                  • Why the fuck is this still so difficult in the year 2026
                                  fastfinge@fed.interfree.caF This user is from outside of this forum
                                  fastfinge@fed.interfree.caF This user is from outside of this forum
                                  fastfinge@fed.interfree.ca
                                  schrieb zuletzt editiert von
                                  #17
                                  @skye Properly tagged PDFs can work, but depending on how the PDF is generated, getting the tagging done correctly can be anything from slightly tricky to impossible. But if you go with epub, it's pretty much the same as generating accessible HTML. A lot easier.
                                  skye@toot.catS 1 Antwort Letzte Antwort
                                  0
                                  • nicolai@babka.socialN nicolai@babka.social

                                    @skye I am sighted but I used to work as an assistant for a blind student and specifically it was my job to convert text into something screen reader compatible/comfortable, so I think I can add a little bit:
                                    Not all screen reader software is similarly capable. Also braille has no capital letters and some people use 8 (syllables) and 6 (letters) point braille, while some only 6 (letters) and others only text to speech.
                                    PDF is a real surprise box of a format. You never know what it is really like. It is all but guaranteed that your PDF will handle semantics properly and that the different screen readers will do the same. Avoid it whenever you can.
                                    Simpler formats are much better. Plaintext, RTF, Markdown, HTML (only text and lists, no tables, with semantic formatting).
                                    Remember that tables work barely or not at all and less but consistent semantic formatting is more. (Sub)chapter titles are good. Many screen readers allow jumping between them, useful. Braille is slower to read than black print

                                    nicolai@babka.socialN This user is from outside of this forum
                                    nicolai@babka.socialN This user is from outside of this forum
                                    nicolai@babka.social
                                    schrieb zuletzt editiert von
                                    #18

                                    @skye in practice using markdown to get proper semantic HTML is a good workflow. There are nice free markdown editors that offer you some comfort as an author, even if you never wrote a line of HTML in your life. Also those you can send to anyone because due to the ubiquitous web there is almost no device that does not render HTML somehow

                                    An HTML website that is just a single document is easy to download and people who navigate the world with a screenreader usually know how to do that (it is „file>save as“ or the share button on your phone if you forgot)

                                    nicolai@babka.socialN 1 Antwort Letzte Antwort
                                    0
                                    • weirdwriter@caneandable.socialW weirdwriter@caneandable.social

                                      @skye Markdown. Never do PDF ever. Saving it as HTML is best too since they can open local HTML files

                                      fastfinge@fed.interfree.caF This user is from outside of this forum
                                      fastfinge@fed.interfree.caF This user is from outside of this forum
                                      fastfinge@fed.interfree.ca
                                      schrieb zuletzt editiert von
                                      #19
                                      @WeirdWriter @skye The issue with HTML is that a lot of browsers these days will refuse to download HTML, and will just open it. For less techy people, actually saving an HTML file they got from a link can be challenging. And markdown is fine on desktop, but I'm not aware of anything on mobile that allows navigating by headings in a markdown file. Personally I'd say epub. There are free programs on all the platforms that can open epub, browsers just download it by default, making accessible epubs is as easy as making accessible html, and it will work for blind and sighted alike so you don't need to create two different documents.
                                      weirdwriter@caneandable.socialW 1 Antwort Letzte Antwort
                                      0
                                      • skye@toot.catS skye@toot.cat

                                        Hey blind people, what is the recommended accessible format for distributing text-only content? So that a short text of a couple hundred words is browsable, searchable and the structure is understandable?

                                        Am I correct is assuming that a well-structured PDF with all the titles set correctly would do the trick? Or is there some secret file format that is much better suited?

                                        The document is intended to be distributed as downloadable file, not as a website.

                                        (Sighted people feel free to boost but for the love of everything please do not try to answer)

                                        Edit: So what I have gathered

                                        • PDF actually a terrible option
                                        • HTML good, but not easily downloadable
                                        • Epub probably good, and easily downloadable
                                        • Markdown might be preferred for people that know how to work with them
                                        • Why the fuck is this still so difficult in the year 2026
                                        mildsunrise@tech.lgbtM This user is from outside of this forum
                                        mildsunrise@tech.lgbtM This user is from outside of this forum
                                        mildsunrise@tech.lgbt
                                        schrieb zuletzt editiert von
                                        #20

                                        @skye just chiming in to say: an .epub is basically a self contained website that behaves like a book when opened in a reader. you get the semantics of HTML without the logistical hurdles of having to inline all resources (although in this case it doesn't look like there'd be many to begin with)

                                        1 Antwort Letzte Antwort
                                        0
                                        • nicolai@babka.socialN nicolai@babka.social

                                          @skye in practice using markdown to get proper semantic HTML is a good workflow. There are nice free markdown editors that offer you some comfort as an author, even if you never wrote a line of HTML in your life. Also those you can send to anyone because due to the ubiquitous web there is almost no device that does not render HTML somehow

                                          An HTML website that is just a single document is easy to download and people who navigate the world with a screenreader usually know how to do that (it is „file>save as“ or the share button on your phone if you forgot)

                                          nicolai@babka.socialN This user is from outside of this forum
                                          nicolai@babka.socialN This user is from outside of this forum
                                          nicolai@babka.social
                                          schrieb zuletzt editiert von
                                          #21

                                          @skye also be aware that the overwhelming majority of blind people are those who lose their sight at very old age (think 80+). They are often unwilling or incapable of learning braille and screenreaders properly. So some advice written by non-blind and especially institutions of care or the state centres their experience. But realistically the people who work with screenreaders are mostly young(ish) people who have been blind their whole life or lost sight early in life and of course move very differently through life. Lots of things focus on the elderly who are blind for a few years before dying. If in doubt, and if you aren’t specifically offering something consumed mostly by very old people, it is better to focus on the young and their needs

                                          nicolai@babka.socialN 1 Antwort Letzte Antwort
                                          0
                                          Antworten
                                          • In einem neuen Thema antworten
                                          Anmelden zum Antworten
                                          • Älteste zuerst
                                          • Neuste zuerst
                                          • Meiste Stimmen



                                          Copyright (c) 2025 abSpecktrum (@abspecklog@fedimonster.de)

                                          Erstellt mit Schlaflosigkeit, Kaffee, Brokkoli & ♥

                                          Impressum | Datenschutzerklärung | Nutzungsbedingungen

                                          • Anmelden

                                          • Du hast noch kein Konto? Registrieren

                                          • Anmelden oder registrieren, um zu suchen
                                          • Erster Beitrag
                                            Letzter Beitrag
                                          0
                                          • Home
                                          • Aktuell
                                          • Tags
                                          • Über dieses Forum