Having subfigures side-by-side in a 2 column fashion.

[atharvaaalok]

How can I position two sub figures such that one is on the left and the other on the right but aligned horizontally?

[choldgraf]

I believe that you could accomplish this with the {grid} directive, and two {grid-item} directives inside of it. You could do this with {code-cell} directives to run the code in-line, or you could use {embed} functionality to attach labels to image outputs, then embed them in the grid with {figure} directives.

For example, the following MyST:

## Generate figures

```{code-cell}
:label: fig1
import numpy as np
import pandas as pd
_ = pd.DataFrame(np.random.randn(100, 2)).plot()
```

```{code-cell}
:label: fig2
_ = pd.DataFrame(np.random.randn(100, 2)).plot()
```

## Display as grid

:::::{grid} 2
::::{grid-item}
:::{figure} #fig1
Caption for the first figure.
:::
::::
::::{grid-item}
:::{figure} #fig2
Caption for the second figure. Cool that they are in columns!
:::
::::
:::::

generates something like this:

[atharvaaalok]

Thank you for the quick response! This is a nice way of putting figures in columns.
But My figure captions are NOT vertically aligned like yours. This is because my two images are not of the same size and aspect ratio and I scale them differently for visual aesthetic.
Also, the figures using the grid method are no longer sub-figures. Instead they are labeled Figure 1 and 2 automatically.

I have asked another question here: https://github.com/orgs/jupyter-book/discussions/1764