Wolfram Language & System Documentation Center

Export   

Listing of Formats »

Export["dest.ext",expr]

exports data to a file, converting it to the format corresponding to the file extension ext.

Export[dest,expr,"fmt"]

exports data in the specified format "fmt".

Export[dest,exprs,elements]

exports data by treating exprs as elements.

Export[dest,exprs,elements,options]

uses the specified options.

Details

Export handles a large number of formats, each typically with many different possible elements. The possible formats are given in the list $ExportFormats, and in the "Listing of All Formats".
By default, Export creates a file in the current directory given by Directory[].
In Export[dest,…], dest can be any of the following:
"file" or File["file"] explicit file name

"!prog" export data to a pipe

CloudObject[…] a cloud object

LocalObject[…] a local object
The following combinations of exprs and elements can be given:

expr	elem	export expr as elem
{expr₁,expr₂,…}	{{elem₁,elem₂,…}}	export expr_i as elem_i
{expr₁,expr₂,…}	{elem₁,subelem₁,…}	export expr_i as sublement subelem_i of elem₁
rules	"Rules"	export elements and expressions rules

When specifying the format, the following elements specifications can be given:

	{"format",elem}	a single element
	{"format",{elem₁,elem₂,…}}	multiple elements
	{"format",elem₁,sublelem₁,…}	subelements of subelements of elem₁
	{"format",rules}	export elements and expressions rules

When exporting using the "Rules" element, rules can have the following forms:

	elem->val	a value for a single element
	{elem₁->val₁,elem₂->val₂,…}	values for several elements
	elem₁->val₁,elem₂->val₂,…	an association for several elements
	elem₁->{elem₁₁->val₁₁,…}	values for subelements

Export takes an OverwriteTarget option for all formats. Possible settings include:

	False	do not overwrite an existing file
	True	overwrite an existing file (default)
	"KeepBoth"	keep the existing file, automatically choosing a name for the new file

Use Export[dest,…,options] to provide format-specific options that control the behavior of the export.
Export[file,NotebookObject[…],…] when possible exports the content of the notebook referenced by the NotebookObject.
New formats can be manually registered in the Wolfram Language. See the tutorial for "Developing an Export Converter".

Examples

open all close all

Basic Examples (4)

Export an image object:

Export a plot as a GIF:

Export a formula as a GIF:

Export a sound as a MIDI file:

Scope (11)

Basic Uses (3)

Export a SparseArray to a Matrix Market file:

Export a Dataset to a "JSONLines" file:

Export a Tabular object to a "Parquet" file:

Types of Formats (8)

Audio (1)

Export an Audio object to an "MP3" file:

Graphics (1)

Export a Graphics object to an "SVG" file:

3D Graphics (1)

Export a 3D model to an "X3D" file:

Image (1)

Export an Image object to a "JPEG" file:

Spreadsheet (1)

Export a Tabular object to an "XLSX" file:

Text (2)

Export some text to a text file:

Export a matrix to a "Markdown" file:

Video (1)

Export an animation to an "MP4" file:

Generalizations & Extensions (2)

Local objects can be used with Export and Import to store data persistently:

Cloud objects can be used with Export and Import to store data persistently:

Options (1)

OverwriteTarget (1)

Create a file:

By default, Export overwrites an existing file:

Use OverwriteTargetFalse to avoid overwriting:

Properties & Relations (1)

The first format returned by FileNameToFormatList is used by default in Export:

Specify a different export format:

Top

More Learning

Tech Support

Wolfram Solutions

Wolfram Solutions For Education

Get Started

Grow Your Skills

Work with Us

Educational Programs for Adults

Educational Programs for Youth

Read

Export

Details

Examples

Basic Examples (4)