Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Looks really slick. Thanks for the contribution!

I don't know if this is sacrilege or not here but I really like reStructuredText's list-table directive [1] for this kind of thing. It provides a text-friendly editable representation that renders to a nice table. There's a CSV-based table directive also (scroll up one in the link).

   .. list-table:: Frozen Delights!
      :widths: 15 10 30
      :header-rows: 1

      * - Treat
        - Quantity
        - Description
      * - Albatross
        - 2.99
        - On a stick!
      * - Crunchy Frog
        - 1.49
        - If we took the bones out, it wouldn't be
          crunchy, now would it?
      * - Gannet Ripple
        - 1.99
        - On a stick!
I like Markdown a lot for simple things like notes and readmes. When I write technical documentation and when I wrote my e-book, RST had the extended feature set I needed.

[1] https://docutils.sourceforge.io/docs/ref/rst/directives.html...



When it comes to 'text-friendly' I far prefer nicely formatted MMD tables...

  | Treat         | Quantity   | Description                                                     |
  | :------------ | :--------  | :-------------------------------------------------------------- |
  | Albatross     | 2.99       | On a stick!                                                     |
  | Crunchy Frog  | 1.49       | If we took the bones out, it wouldn't be crunchy, now would it? |
  | Gannet Ripple | 1.99       | On a stick!                                                     |
  [Frozen Delights!]
...despite the comparative hassle in editing them. It's just so much more readable at a glance later.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: