Args Table in Markdown

Args Table in Markdown

I have a Python project with a README.rst it’s a CLI tool the README has a tidy little args table.
It can be found here

Usage
-----
.. code-block:: bash

  pip install markdown-mermaid-to-images
  markdown_mermaid_to_images --help

Usage: markdown_mermaid_to_images [OPTIONS]

  Exports mermaid diagrams in Markdown documents as images.

Options:
  -m, --file PATH                 Path to markdown file, where the mermaid
                                  code blocks will be converted to images.
  -f, --folder PATH               Path to folder where we will convert all
                                  markdown mermaid code blocks to images.
  -i, --ignore PATH               Path to folder to ignore, markdown files in
                                  this folder will not be converted.
  -o, --output PATH               Path to folder where to save the new
                                  markdown files.  [required]
  -l, --log-level                 [DEBUG|INFO|ERROR]
                                  Path to folder where to save the new
                                  markdown files.
  --help                          Show this message and exit.

.. code-block:: bash

    $ markdown_mermaid_to_images -f tests/data -o tests/data/output/ -i tests/data/another_folder

I was wondering how can get this same table in a normal markdown file. I’ve been trying to do the same for this project.
The best I could was to put into a code block to it’s atleast readable.

### Args
```bash
npm run start -- --help
Usage: src [options]

  Updates description of Docker Hub repository.

Options:
  --version         Show version number                               [boolean]
  -u, --username    Docker Hub username.                              [required]
  -p, --password    Docker Hub password (cannot be an access token).  [required]
  -r, --repoName    The repository name that you want to update the description
                    off.                                              [required]
  -x, --repoPrefix  The prefix of the repository you want to  update, If not set
                    defaults to username.
  -f, --readmePath  Path to README file which will be used as the description of
                    repository on Docker Hub.           [default: "./README.md"]
  -h, --help        Show help                                          [boolean]

Image below shows what I would like to do in the Markdown.

This is currently what the Markdown file looks like.

Thanks

It’s been a while since your post, so you’ve probably found a solution. But if someone else is looking: Gitlab flavored markdown can tolerate a certain amount of html, so you could use the general table tags below:

<table>
<tr>
<td><img src="your image path here" width="400px" /></td>  <!-- Note: set width to resize -->
<td></td>   <!-- no data in this cell -->
</tr>
<tr>
<td></td>   <!-- no data in this cell -->
<td>your text description here</td>
</tr>
</table>

Note: You can also use the <th> tag in lieu of the first set of <td> tags to format the column headers (bold font, gray cell background).

I haven’t had success in merging cells, so your image would be in a cell in the left column.