Skip to content

Run Markdown with Jupyter and preview side-by-side in Atom

Notifications You must be signed in to change notification settings

nathancarter/md-jupyter-html

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Goal

In RStudio, while editing an .Rmd file, a single keystroke runs knitr and displays the compiled version, with code chunks run, output displayed, and Markdown typeset, next to the source.

I'd like such a UX for any Jupyter-supported language.

This file solves that problem.

Animated GIF screencast

Requirements

This tiny piece of work combines excellent tools made by tons of other people. Here's what you need:

  1. The Atom editor
  2. Atom's build package
  3. Atom's browser-plus package
  4. Jupyter installed and in your path
  5. Jupytext installed and in your path

Installation

  1. Drop the .atom-build.js file from this repository into the same folder as the .md file(s) you're editing in Atom. It defines a custom build process that Atom will notice.
  2. Invoke build (Ctrl/Cmd+B) from within a .md file in Atom.

Atom will compile it to HTML (running the code chunks along the way) and show you the result to the right of your source, refreshing the view if needed.

License

LGPLv3

About

Run Markdown with Jupyter and preview side-by-side in Atom

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published