Notebook Import and Export

Hydrogen makes it easy to convert between text files and Jupyter Notebook (.ipynb) files. You can both export text files to Jupyter Notebook files and import Jupyter Notebook files as text files. This works for any programming language for which you have a Jupyter kernel installed.

Access the import and export commands by opening the command palette with Ctrl+Shift+P or Cmd+Shift+P and searching for "Hydrogen: Import Notebook" or "Hydrogen: Export Notebook". You can easily assign your own keybinding to these commands if you'd like.

Notebook Import

Run "Hydrogen: Import Notebook" and select the desired notebook file in the file browser that opens. That's it! The file will be imported into a new Atom tab, using cell markers to delimit the individual code and markdown blocks.

Note: The syntax highlighting package for the given programming language must be installed and active.

Notebook Export

With text like the following, running "Hydrogen: Export Notebook" will export code and markdown cells to a Notebook file of your choosing.

# %%
print('Hello, world!')
# %% markdown
# A **Markdown** cell!

Cell Markers

A cell marker is a special inline comment that defines the lines that begin each cell. The inline comment must start with the comment character registered in the language's grammar file.

  • Python: #
  • R: #
  • Julia: #
  • Javascript: //
  • C++: //
  • Stata: //
  • Matlab: %

Code Cells

After the comment character, you need to add one space plus any of the following markers on the same line:

  • %%
  • <codecell>
  • In[] (you can have any number of digits or spaces in the brackets)

For example, the following text corresponds to three code cells in a Python file

# %%
print('Hello, world!')
# <codecell>
print('foo')
# In[1]
print('bar')

These are the same cell markers used by "Hydrogen: Run Cell".

Markdown Cells

You can also create cells with Markdown-formatted text. Just as for code cells, there are a range of allowed markers to delimit the start of a markdown cell:

  • %% md
  • %% [md]
  • %% markdown
  • %% [markdown]
  • <md>
  • <markdown>

Each line of text in the cell's body should be prefixed by the language's comment character. Any common leading whitespace in the cell will be stripped, so the body text can include a space after the comment symbol without having leading whitespace in the output and with indented lists keeping their structure.

For example, here are two markdown cells in a Python file

# %% [markdown]
# _italic text_
# **bold text**
# <markdown>
# - Indented
#     - Lists

the two cells would be exported without any common leading whitespace as

_italic text_
**bold text**

and

- Indented
    - Lists

Raw Cells

Hydrogen doesn't support the export of raw cells at this time.

results matching ""

    No results matching ""