Файл .ipynb: что это и чем открыть

Что такое файл .ipynb

.ipynb — это файл Jupyter Notebook (раньше назывался IPython Notebook, отсюда и расширение), который хранит код, текст и результаты выполнения вместе, в формате JSON. Внутри notebook разбит на ячейки: ячейки с кодом (чаще всего на Python, но Jupyter поддерживает и другие языки), ячейки с текстом в разметке Markdown и, отдельно, вывод выполнения — текстовый результат, таблицы, графики и изображения, которые Jupyter сохраняет прямо внутри файла.

Именно поэтому .ipynb стал стандартом обмена в анализе данных, машинном обучении и обучающих материалах: один файл одновременно содержит и код, и объяснение к нему, и готовый результат — не нужно пересчитывать всё заново, чтобы увидеть, что получилось.

Упрощённый фрагмент структуры (без деталей метаданных):

Поле JSON	Что хранит
`cells`	Список ячеек — код, markdown-текст и их вывод
`cell_type`	Тип ячейки: `code` или `markdown`
`outputs`	Результат выполнения ячейки: текст, таблица, график, изображение
`metadata.kernelspec`	Какое ядро (язык и версия) использовалось для выполнения

Как открыть .ipynb в Jupyter Notebook (классический способ)

Jupyter Notebook — родное приложение для .ipynb, оно же его и создаёт. Если на компьютере уже есть Python, установка занимает одну команду.

Если Python ещё не установлен, сначала поставьте его с python.org.
Откройте терминал (или командную строку) и выполните pip install jupyter — это установит сам Jupyter и все нужные зависимости.
Перейдите в папку с файлом и запустите jupyter notebook имя.ipynb — откроется браузер с интерфейсом Jupyter и загруженным notebook.
В интерфейсе видно все ячейки сразу: код, текст и сохранённый вывод. Чтобы пересчитать ячейку заново, нужно явно нажать «Выполнить» (Run) — просто открыв файл, код не запускается.

Как открыть .ipynb без установки Jupyter — 4 способа

Если ставить Python и Jupyter ради одного файла не хочется, есть варианты, которые требуют меньше действий или вообще ничего не устанавливают.

VS Code

Visual Studio Code с расширением Jupyter открывает .ipynb прямо в редакторе — с теми же ячейками, возможностью редактировать и выполнять код. Вариант для тех, кто уже пишет код и хочет не переключаться между приложениями.

Google Colab

Загрузите файл на Google Colab (File → Upload notebook) — он откроется прямо в браузере, со всей функциональностью Jupyter, но без единой установки на компьютер. Нужен только аккаунт Google и интернет.

NBViewer и онлайн-просмотрщики

Если нужно просто посмотреть содержимое, не запуская код, подойдёт NBViewer или похожие онлайн-вьюеры — загружаете файл или вставляете ссылку, сервис показывает ячейки и сохранённый вывод как статическую страницу. Код при этом не выполняется — это самый безопасный способ посмотреть notebook из непроверенного источника (подробнее — в разделе про безопасность ниже).

GitHub

Если .ipynb уже лежит в репозитории на GitHub, он рендерится автоматически прямо на странице файла — ничего скачивать не нужно, GitHub сам показывает ячейки и вывод в читаемом виде.

Способ	Нужна установка	Можно редактировать	Можно выполнять код
Jupyter Notebook	Да, Python + Jupyter	Да	Да
VS Code	Да, VS Code + расширение	Да	Да
Google Colab	Не нужна	Да	Да
NBViewer	Не нужна	Нет	Нет
GitHub (превью файла)	Не нужна	Нет	Нет

«Файл открылся как текст» и другие ошибки

Открылся сырой текст или JSON — это не повреждение

Если дважды кликнуть по .ipynb без привязанной программы, система откроет его как обычный текстовый файл — и вы увидите фигурные скобки, кавычки и служебные поля JSON вместо нормального вида с ячейками. Файл цел, просто его открыли не той программой: нужно явно запустить Jupyter, VS Code или загрузить файл в Colab/NBViewer, а не кликать по нему в проводнике.

Чтобы .ipynb по умолчанию предлагал открыть подходящую программу, в Windows кликните по файлу правой кнопкой → «Открыть с помощью» → «Выбрать другое приложение» и укажите VS Code (если он установлен). Для самого Jupyter такой привязки обычно не делают — notebook всё равно удобнее открывать командой из терминала, из нужной папки с проектом.

Отдельная ошибка — сообщение вида «Notebook does not appear to be valid JSON» при попытке открыть файл в Jupyter или VS Code. Это значит, что файл реально повреждён: он либо скачан не полностью (оборвалась загрузка), либо был испорчен при пересылке. Проверьте размер файла и попробуйте скачать его заново — лучше через облако или файловый архив, а не через мессенджер, который иногда обрезает вложения.

Как конвертировать .ipynb в PDF

Если notebook нужно отправить коллеге, который не работает с кодом, удобнее превратить его в обычный документ.

Через интерфейс Jupyter. В открытом notebook выберите File → Download as → PDF via HTML.
Через командную строку. Согласно документации проекта nbconvert, команда jupyter nbconvert --to pdf имя.ipynb конвертирует файл в PDF без открытия интерфейса — удобно для пакетной обработки нескольких файлов.
Через Google Colab. Откройте файл в Colab и выберите File → Print → «Сохранить как PDF» — ничего устанавливать не нужно, подойдёт, если под рукой только браузер.

Как конвертировать .ipynb в HTML и в обычный Python-скрипт

Тот же инструмент nbconvert умеет и другие форматы, не только PDF.

jupyter nbconvert --to html имя.ipynb — получаете HTML-страницу, которую можно открыть в любом браузере без Jupyter и без Python. Хорошо подходит, когда нужно именно посмотреть результат, сохранив все графики и форматирование.
jupyter nbconvert --to script имя.ipynb — извлекает только код ячеек в чистый .py-файл, без markdown-текста и сохранённого вывода. Нужно, когда notebook использовали для экспериментов, а в продакшен нужно забрать только рабочий код.

Практическое правило: HTML — когда нужно показать готовый результат с графиками кому-то без Jupyter; PDF — когда документ должны распечатать или прикрепить к отчёту; .py — когда из notebook нужно забрать именно код для дальнейшей разработки.

Безопасно ли открывать .ipynb из незнакомого источника

⚠

Ячейки с кодом выполняются, а не просто читаются

Notebook — это не документ, а исполняемый код. Если запустить все ячейки (Run All) в незнакомом .ipynb, присланном по почте или скачанном из непроверенного архива, код внутри выполнится на вашем компьютере с теми же правами, что и любая другая программа. Не запускайте выполнение notebook из источников, которым не доверяете.

Просто посмотреть содержимое безопасно: NBViewer, превью на GitHub или просмотр в текстовом редакторе показывают ячейки и уже сохранённый вывод, но не выполняют код — риска нет. Опасность появляется именно в момент запуска (Run/Run All) в Jupyter, VS Code или Colab. Если файл выглядит подозрительно или прислан неожиданно, стоит свериться с общим списком форматов, с которыми нужно быть осторожнее — разбор есть в статье опасные расширения файлов: что нельзя открывать без проверки.

Частые вопросы

Можно ли открыть .ipynb в Word или Excel?

Нет. .ipynb — это код и JSON-структура, а не текстовый документ или таблица: Word и Excel не умеют его распознавать. Для просмотра используйте Jupyter, VS Code, Google Colab или NBViewer, а для документа — сначала сконвертируйте файл в PDF или HTML.

Чем открыть .ipynb на телефоне?

Проще всего через Google Colab в мобильном браузере — он работает без установки приложений. Есть и отдельные мобильные приложения-просмотрщики Jupyter notebook, но они обычно умеют только показывать содержимое, без выполнения кода.

Можно ли редактировать .ipynb в обычном текстовом редакторе?

Технически да — это текстовый JSON-файл, и его можно открыть в «Блокноте» или любом текстовом редакторе. Но редактировать так неудобно и рискованно: легко случайно сломать структуру JSON, и файл перестанет открываться в Jupyter. Для правок используйте сам Jupyter, VS Code или Colab.

.ipynb и .py — в чём разница?

.py — это обычный Python-скрипт, только код, без текста и сохранённого вывода. .ipynb — notebook, где код разбит на ячейки и перемешан с текстовыми пояснениями и результатами выполнения (таблицами, графиками). Превратить .ipynb в .py можно командой jupyter nbconvert --to script.

Весит ли файл .ipynb больше из-за вывода кода?

Да. Если в ячейках сохранены графики или изображения, они хранятся прямо внутри .ipynb в закодированном виде, и размер файла растёт — иногда заметно, особенно при большом количестве визуализаций. Чистый код с текстом весит заметно меньше.

Нужен ли интернет, чтобы открыть .ipynb в Google Colab?

Да — Colab работает в браузере и выполняется на серверах Google, поэтому без подключения к интернету загрузить и открыть файл не получится. Для офлайн-работы нужен локально установленный Jupyter или VS Code.

Почему в .ipynb из чужого источника иногда не видно графиков?

Чаще всего потому, что графики не были сохранены как вывод ячейки на момент последнего запуска — notebook хранит только то, что было выполнено и выведено до сохранения файла. Чтобы увидеть графики, нужно открыть файл в Jupyter или Colab и заново выполнить соответствующие ячейки.

Что такое файл .ipynb и чем его открыть

Что такое файл .ipynb

Как открыть .ipynb в Jupyter Notebook (классический способ)