5 Best Ways to Write a Python Program to Export a DataFrame to an HTML File

Rate this post

💡 Problem Formulation: When working with data in Python, a common task is to export data for presentation or sharing. A DataFrame, which is a 2-dimensional labeled data structure in pandas, often requires visualization in a simplified and accessible format. An HTML file serves this purpose, capturing the structure and format conveniently. Suppose we have a pandas DataFrame containing sales data; our objective is to export this data to an HTML file that can be opened with any web browser.

Method 1: Using pandas to_html()

Data scientists often need to convert their data into a more presentable format. Pandas provides the to_html() method, which allows users to convert a DataFrame into an HTML table. It’s a straightforward function that can be customized with various parameters to alter the table’s appearance, such as adding a border or index names.

Here’s an example:

import pandas as pd

# Sample DataFrame
data = {'Product': ['Widget', 'Gizmo'], 'Sales': [50, 30]}
df = pd.DataFrame(data)

# Convert DataFrame to HTML and write to a file
html_output = df.to_html()
with open('sales_data.html', 'w') as file:

The output is an HTML file named ‘sales_data.html’ containing a table with our data.

This code snippet creates a pandas DataFrame containing a small dataset. It then converts the DataFrame to an HTML table format string using the to_html() method. Finally, it writes that string to an HTML file using Python’s built-in open() function and file handling.

Method 2: Pandas with Styling Options

Beyond a simple table, pandas also allows for styling of tables before exporting them to HTML. The DataFrame’s style property provides several options to enhance the visual appeal of the table, such as applying conditional formatting, adding bar charts within cells, or fine-tuning other CSS properties.

Here’s an example:

import pandas as pd

# Sample DataFrame
data = {'Product': ['Widget', 'Gizmo'], 'Sales': [50, 30]}
df = pd.DataFrame(data)

# Convert DataFrame to a styled HTML and write to a file
styled_html = df.style.highlight_max(axis=0).render()
with open('styled_sales_data.html', 'w') as file:

The output is an HTML file named ‘styled_sales_data.html’ with highlighted maximum values.

This snippet follows the same initial steps as Method 1 but then applies a styling option using style.highlight_max() which highlights the maximum value in each column. The render() method is then used to generate the HTML content with the applied style, which is written to the file ‘styled_sales_data.html’.

Method 3: Using DataFrame.to_html() with a Template Engine

For advanced customization needs, a DataFrame can be integrated into an existing HTML template using a template engine like Jinja2. This method is ideal when the HTML output needs to be embedded into a larger HTML framework, such as a webpage or a report that requires specific styling and additional HTML elements around the table.

Here’s an example:

from jinja2 import Template
import pandas as pd

# Sample DataFrame
data = {'Product': ['Widget', 'Gizmo'], 'Sales': [50, 30]}
df = pd.DataFrame(data)

# Jinja2 Template
template = Template('''
<h1>Sales Data</h1>
{{ table }}

html_output = template.render(table=df.to_html())
with open('template_sales_data.html', 'w') as file:

The output is an HTML file named ‘template_sales_data.html’ with the DataFrame in a more comprehensive HTML structure including a title.

This code utilizes a Jinja2 template to define an HTML structure where the DataFrame’s HTML table will be placed. The render() method of the template object replaces the placeholder with the HTML generated by pandas to_html(), and the complete HTML content is saved to a file.

Method 4: Using DataTables with pandas

For users who need interactive tables with features like search, paging, and sorting, the DataTables jQuery plugin can be used in combination with pandas. By using the to_html() method in conjunction with DataTable-related classes and scripts, the resulting HTML file offers a more dynamic user experience with enhanced functionality.

Here’s an example:

import pandas as pd

# Sample DataFrame
data = {'Product': ['Widget', 'Gizmo'], 'Sales': [50, 30]}
df = pd.DataFrame(data)

# Convert DataFrame to HTML with DataTables classes
html_output = df.to_html(classes='display')
with open('data_tables_sales_data.html', 'w') as file:
    # Add DataTable script and links
<link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/1.10.20/css/jquery.dataTables.css">
<script type="text/javascript" charset="utf8" src="https://cdn.datatables.net/1.10.20/js/jquery.dataTables.js"></script>

The output is an HTML file named ‘data_tables_sales_data.html’ containing an interactive table enhanced by the DataTables plugin.

This code turns a DataFrame into an HTML table that includes the display class needed by the DataTables plugin. Additionally, the appropriate DataTables CSS and JavaScript are added to the file, initializing the interactive features on the DOM-ready event.

Bonus One-Liner Method 5: Using to_html() With open()

For the ultimate shortcut, pandas and Python’s file handling can be combined in a single expressive line of code. This one-liner approach is perfect for quick tasks where an HTML file is needed with no fuss or added complexity.

Here’s an example:

pd.DataFrame({'Product': ['Widget', 'Gizmo'], 'Sales': [50, 30]}).to_html(open('one_liner_sales_data.html', 'w'))

The output is an HTML file named ‘one_liner_sales_data.html’ containing the data represented as a simple HTML table.

This one-liner creates a pandas DataFrame, converts it to an HTML table, and immediately writes it to a file, showcasing the power of Python’s concise syntax.


  • Method 1: Basic pandas to_html(). Quick and easy. Lacks styling and advanced features.
  • Method 2: Pandas with Styling Options. Offers enhanced visual output. Requires basic knowledge of pandas styling methods.
  • Method 3: Using a Template Engine. Highly customizable. Perfect for integration into larger projects. Slight learning curve for Jinja2 syntax.
  • Method 4: Using DataTables with pandas. Creates feature-rich tables. Requires inclusion of DataTables resources.
  • Bonus Method 5: The One-Liner. Ideal for quick exports. Not suitable for customization or larger-scale projects.