I'm trying to setup org-mode as a substitute for jupyter notebook using emacs-jupyter. My problem right now is how to display pandas dataframes. When the dataframe contains cells with a lot of text for example, displaying it as an org table is quite messy. and displaying it with :display plain is ok but not very compact.

What I'd like is to have org-mode display dataframes as an inline image, similar to what happens in a jupyter notebook.

I'm trying to do this using wkhtmltoimage with the :post header argument, but so far was not able to get source block to output a raw html text without the export html wrap (#+begin_export html...#+end_export). I tried with :results value raw but that didn't work.

Any suggestions? Or any other way to accomplish what I want?

I use:

  • Emacs 27.2
  • Spacemacs v.0.300.0
  • 1
    How about adding an example source block that shows what you are trying to do? That would allow interested people who are not experts (e.g. I've never used emacs-jupyter or wkhtmltoimage) to try things out and maybe come up with suggestions or a solution. I don't know about others' estimates, but mine was that it would take too long to set things up and try it out, so I am not going to try. The thing is you limit the pool of potential answerers if you don't provide enough detail: and if the pool is empty, you are out of luck.
    – NickD
    Jan 30, 2022 at 23:10
  • 1
    This is just a very wild guess and I haven't checked myself, but perhaps the github.com/jkitchin/scimax Emacs distribution might have figured this out.
    – aadcg
    Jan 31, 2022 at 11:39

3 Answers 3


I guess this is close to what you want. I was a little lazy, here is an html2image package in python. you could also do this with wkhtmltoimage

pip install html2image

here is a post run block to take an html string and make an image

#+name: html2img
#+BEGIN_SRC python :var html="" :results value
from html2image import Html2Image
import hashlib
import os

m = hashlib.sha256(html.encode('utf-8')).hexdigest()

hf = m + '.html'
pf = m + '.png'

with open(hf, 'w') as f:

hti = Html2Image()
hti.screenshot(url=hf, save_as=pf)
return f'''
,#+attr_org: :width 1200

Here is an example:

#+BEGIN_SRC jupyter-python :pandoc :post html2img(*this*) :results raw
import pandas as pd

f = pd.DataFrame([['a', 'b','really really really long text']*13, [1, 2, 3]*13])

That has this output. It is close to what a notebook does for me.



scimax (based on @aadcg's comment) does have a solution to display pandas dataframes and other figures as images in org-mode.

There are a couple examples they provide, but one uses https://github.com/jkitchin/pycse/blob/master/pycse/orgmode.py, which seems to produce your desired results (may require latex and/or pandoc).

from pycse.orgmode import *

Table([['x', 'y'],
       [1, 2],
       [3, 4]],
      caption='The information about the table',
      attributes=[('latex', ':environment longtable :align |l||l|')])
  • Not sure I understand what kind of result output this will display but I'll give it a shot.
    – J.Doe
    Feb 3, 2022 at 9:01

I have the following in my ~/.ipython/profile_default/startup/50-middle.py startup file.

# this make emacs-jupyter only show Org (not HTML) as results
# https://github.com/gregsexton/ob-ipython
  import IPython
  from tabulate import tabulate
  class OrgFormatter(IPython.core.formatters.BaseFormatter):
      def __call__(self, obj):
          return tabulate(obj, headers='keys', tablefmt='orgtbl', showindex='always')
          return None

  ip = get_ipython()
  ip.display_formatter.formatters['text/org'] = OrgFormatter()
except ImportError:
  print("no tabulate")

And when I use emacs-jupyter blocks with Pandas, I see tabular output.


#+BEGIN_SRC jupyter-python
import numpy as np
import pandas as pd
pd.DataFrame(np.random.random((3,3)), columns=['a','b','c'])

|   |         a |        b |        c |
| 0 |   0.37454 | 0.950714 | 0.731994 |
| 1 |  0.598658 | 0.156019 | 0.155995 |
| 2 | 0.0580836 | 0.866176 | 0.601115 |

  • Displaying dataframe as org table does not solve the problem of long text in cells etc.. As I mention in the question, I'm trying to reproduce similar behavior as in jupyter notebook where long text in cells will be truncated and large number of columns\rows similarly truncated. I thought the best solution would be to convert the table into an image.
    – J.Doe
    Feb 3, 2022 at 8:57

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.