Mirror of forum.nim-lang.org

7108 :: Nim's rst parser now supports markdown tables

• miran (orginal) [2020-11-17T13:06:54+01:00] view original

  If you're using Nim devel (v1.5.1), you're not limited anymore to use just rst tables in your documentation:

  
  ========    ===============
  Header 1    Header 2
  ========    ===============
  Content     More content
  Foo         Bar
  Baz         Quux
  ========    ===============
  Run

  which can become cumbersome if some column suddenly needs more space:

  
  ========                 ====================
  Header 1                 Header 2
  ========                 ====================
  Content                  More content
  Foo                      Bar
  Baz                      Quux
  I need more space here   Every row must move
  ========                 ====================
  Run

  Markdown tables to the rescue

  
  | Header 1 | Header 2 |
  | ---- | ---- |
  | Content | More content |
  | Foo | Bar |
  | Baz | Quux |
  Run

  
  | Header 1 | Header 2 |
  | ---- | ---- |
  | Content | More content |
  | Foo | Bar |
  | Baz | Quux |
  | I need more space here | Nothing changes |
  Run

  ---

  Markdown tables are not yet supported on the forum - the support for markdown tables will come with the next forum update.

  Current limitations:

  • cell alignments are not supported (delimiter rows like :---, :---: and ---: are ignored)
  • every table row must start with | (you cannot do Header 1 | Header 2; but you can omit the trailing | if you like: | Header 1 | Header 2)

---

• miran (orginal) [2020-11-17T15:12:38+01:00] view original

  Funny, I didn't even notice that my second rst table is wrong - I didn't change the number of ='s. The way it is written, the contents of the first column of the last row will be "I need ".

  Here is the correct version:

  
  ======================   ====================
  Header 1                 Header 2
  ======================   ====================
  Content                  More content
  Foo                      Bar
  Baz                      Quux
  I need more space here   Every row must move
  ======================   ====================
  Run

  And that's one more reason to use markdown tables ;)

---