fix: align Markdown export table columns with consistent padding (#1000)

Table rows in the Markdown documentation export had no padding,
making the raw output misaligned and hard to read. Added a
formatMarkdownTable helper that calculates the maximum width
per column and pads every cell with padEnd() accordingly.

Applies to field tables, index tables, and type tables.

Fixes #996