Reusing rendered dataframe as table?

[pschumm]

Starting to get acquainted with mystmd and really loving it! Just one thing that I'm missing. As shown in the documentation, I can generate a figure in a notebook, and then capture that cell's output and include it as a figure in an article with something like:

:::{figure} #my-cell
:name: fig-my-cell
:::

What I can't seem to figure out is how to do that with a table. I mean, I see that I can use the table directive with a Markdown table, but suppose my table is a rendered Pandas dataframe, such as that created with Pandas.crosstab()? It's a pretty standard workflow when working in JupyterLab to create tables this way, and it would be great if those could be reused in an article just like figures can be. I'm not asking for any special formatting—just the ability to bring the table over without having to recreate it in Markdown.

Perhaps I'm missing something obvious here? Thanks very much in advance!

[choldgraf]

I think you should be able to embed this using the standard embed syntax. So if you have a cell labeled "mytable" that outputs a table, the following two options would embed that table:

![](#mytable)

```{embed} #mytable
```

[rowanc1]

In addition to that you can wrap it in a table directive or a figure directive of kind table. Which will give you the source and the table caption.

:::{table} This is my table
:label: tbl:here
![](#pd-table)
:::

:::{figure} #pd-table
:label: tbl:there
:kind: table
This is my table caption
:::

Over in jupyter, the cell needs to be labeled with #| label: pd-table.

[choldgraf]

I've got a docs pr incoming later today or tomorrow when I get some time

[choldgraf]

Here's a PR to try and clarify this + some other things:

• 📖 Update Jupyter documentation jupyter-book/mystmd#1069

[pschumm]

Thanks very much @choldgraf and @rowanc1! Exactly what I was looking for (just tried and each of the alternatives you provided works like a champ). I really appreciate the timely replies.