Skip to main content
added 684 characters in body
Source Link
Laurel
  • 6.2k
  • 13
  • 166
  • 231

Code formatted tables are a poor user experience for some users. I think you can tell why:

plus six hyphens plus six hyphens plus vertical bar id vertical bar name vertical bar plus six hyphens plus six hyphens plus vertical bar 1 vertical bar Paul vertical bar vertical bar 2 vertical bar Nash vertical bar vertical bar 3 vertical bar Anne vertical bar vertical bar 4 vertical bar Lily vertical bar plus six hyphens plus six hyphens plus

Here's another example, without the decorations (from MySQL: Long table vs wide table):

id size price

1 S 12 dot 4 1 M 23 dot 1 1 L 33 dot 3 2 S 3 dot 3 2 M 5 dot 3 2 L 11 dot 0

That's what I hear when I use Voiceover, all strung together with no pauses. In contrast, the markdown table is much more navigable and parseable. There are shortcuts to navigate! The voice pauses between each cell! You no longer have to remember how many cells over you are from the end and what the headers are!

To better explain how navigation works, assume you're looking for a column with a specific value. In a code table you have to read all the values that come before the one you want, all while keeping track of where you are in the table and not getting confused with the other columns (can you imagine if you're looking for a number in a table where every value is a number?), so that's roughly the number of columns multiplied by the number of rows above the one you want, assuming you don't get confused and mess up. In contrast, in a markdown table, you navigate to the column you're curious about, then move down the column until you find the value you want. That's linear time!

When in doubt, choose the format that doesn't make it nigh impossible for some people to read. Because, you know, most people aren't using screen readers for fun; it's because they can't navigate the web visually.

Code formatted tables are a poor user experience for some users. I think you can tell why:

plus six hyphens plus six hyphens plus vertical bar id vertical bar name vertical bar plus six hyphens plus six hyphens plus vertical bar 1 vertical bar Paul vertical bar vertical bar 2 vertical bar Nash vertical bar vertical bar 3 vertical bar Anne vertical bar vertical bar 4 vertical bar Lily vertical bar plus six hyphens plus six hyphens plus

Here's another example, without the decorations (from MySQL: Long table vs wide table):

id size price

1 S 12 dot 4 1 M 23 dot 1 1 L 33 dot 3 2 S 3 dot 3 2 M 5 dot 3 2 L 11 dot 0

That's what I hear when I use Voiceover, all strung together with no pauses. In contrast, the markdown table is much more navigable and parseable. There are shortcuts to navigate! The voice pauses between each cell! You no longer have to remember how many cells over you are from the end and what the headers are!

When in doubt, choose the format that doesn't make it nigh impossible for some people to read. Because, you know, most people aren't using screen readers for fun; it's because they can't navigate the web visually.

Code formatted tables are a poor user experience for some users. I think you can tell why:

plus six hyphens plus six hyphens plus vertical bar id vertical bar name vertical bar plus six hyphens plus six hyphens plus vertical bar 1 vertical bar Paul vertical bar vertical bar 2 vertical bar Nash vertical bar vertical bar 3 vertical bar Anne vertical bar vertical bar 4 vertical bar Lily vertical bar plus six hyphens plus six hyphens plus

Here's another example, without the decorations (from MySQL: Long table vs wide table):

id size price

1 S 12 dot 4 1 M 23 dot 1 1 L 33 dot 3 2 S 3 dot 3 2 M 5 dot 3 2 L 11 dot 0

That's what I hear when I use Voiceover, all strung together with no pauses. In contrast, the markdown table is much more navigable and parseable. There are shortcuts to navigate! The voice pauses between each cell! You no longer have to remember how many cells over you are from the end and what the headers are!

To better explain how navigation works, assume you're looking for a column with a specific value. In a code table you have to read all the values that come before the one you want, all while keeping track of where you are in the table and not getting confused with the other columns (can you imagine if you're looking for a number in a table where every value is a number?), so that's roughly the number of columns multiplied by the number of rows above the one you want, assuming you don't get confused and mess up. In contrast, in a markdown table, you navigate to the column you're curious about, then move down the column until you find the value you want. That's linear time!

When in doubt, choose the format that doesn't make it nigh impossible for some people to read. Because, you know, most people aren't using screen readers for fun; it's because they can't navigate the web visually.

added 204 characters in body
Source Link
Laurel
  • 6.2k
  • 13
  • 166
  • 231

Code formatted tables are a poor user experience for some users. I think you can tell why:

plus six hyphens plus six hyphens plus vertical bar id vertical bar name vertical bar plus six hyphens plus six hyphens plus vertical bar 1 vertical bar Paul vertical bar vertical bar 2 vertical bar Nash vertical bar vertical bar 3 vertical bar Anne vertical bar vertical bar 4 vertical bar Lily vertical bar plus six hyphens plus six hyphens plus

Here's another example, without the decorations (from MySQL: Long table vs wide table):

id size price

1 S 12 dot 4 1 M 23 dot 1 1 L 33 dot 3 2 S 3 dot 3 2 M 5 dot 3 2 L 11 dot 0

That's what I hear when I use Voiceover, all strung together with no pauses. In contrast, the markdown table is much more navigable and parseable. There are shortcuts to navigate! The voice pauses between each cell! You no longer have to remember how many cells over you are from the end and what the headers are!

When in doubt, choose the format that doesn't make it nigh impossible for some people to read. Because, you know, most people aren't using screen readers for fun; it's because they can't navigate the web visually.

Code formatted tables are a poor user experience for some users. I think you can tell why:

plus six hyphens plus six hyphens plus vertical bar id vertical bar name vertical bar plus six hyphens plus six hyphens plus vertical bar 1 vertical bar Paul vertical bar vertical bar 2 vertical bar Nash vertical bar vertical bar 3 vertical bar Anne vertical bar vertical bar 4 vertical bar Lily vertical bar plus six hyphens plus six hyphens plus

That's what I hear when I use Voiceover, all strung together with no pauses. In contrast, the markdown table is much more navigable and parseable. There are shortcuts to navigate! The voice pauses between each cell! You no longer have to remember how many cells over you are from the end and what the headers are!

When in doubt, choose the format that doesn't make it nigh impossible for some people to read. Because, you know, most people aren't using screen readers for fun; it's because they can't navigate the web visually.

Code formatted tables are a poor user experience for some users. I think you can tell why:

plus six hyphens plus six hyphens plus vertical bar id vertical bar name vertical bar plus six hyphens plus six hyphens plus vertical bar 1 vertical bar Paul vertical bar vertical bar 2 vertical bar Nash vertical bar vertical bar 3 vertical bar Anne vertical bar vertical bar 4 vertical bar Lily vertical bar plus six hyphens plus six hyphens plus

Here's another example, without the decorations (from MySQL: Long table vs wide table):

id size price

1 S 12 dot 4 1 M 23 dot 1 1 L 33 dot 3 2 S 3 dot 3 2 M 5 dot 3 2 L 11 dot 0

That's what I hear when I use Voiceover, all strung together with no pauses. In contrast, the markdown table is much more navigable and parseable. There are shortcuts to navigate! The voice pauses between each cell! You no longer have to remember how many cells over you are from the end and what the headers are!

When in doubt, choose the format that doesn't make it nigh impossible for some people to read. Because, you know, most people aren't using screen readers for fun; it's because they can't navigate the web visually.

Source Link
Laurel
  • 6.2k
  • 13
  • 166
  • 231

Code formatted tables are a poor user experience for some users. I think you can tell why:

plus six hyphens plus six hyphens plus vertical bar id vertical bar name vertical bar plus six hyphens plus six hyphens plus vertical bar 1 vertical bar Paul vertical bar vertical bar 2 vertical bar Nash vertical bar vertical bar 3 vertical bar Anne vertical bar vertical bar 4 vertical bar Lily vertical bar plus six hyphens plus six hyphens plus

That's what I hear when I use Voiceover, all strung together with no pauses. In contrast, the markdown table is much more navigable and parseable. There are shortcuts to navigate! The voice pauses between each cell! You no longer have to remember how many cells over you are from the end and what the headers are!

When in doubt, choose the format that doesn't make it nigh impossible for some people to read. Because, you know, most people aren't using screen readers for fun; it's because they can't navigate the web visually.