Skip to content

deathbeds/pidgy

Repository files navigation

pidgy literate computing interface

pidgy logo

pidgy is a fun, literate and interactive style of programming in markdown & python. together, these languages offer an exciting new experience to rapidly co-develop of code and narrative in Jupyter computational notebooks.

writing with pidgy

pip install pidgy
install pidgy with `pip`
%reload_ext pidgy
  1. 🪐 open a jupyter notebook
  2. 🔌 activate the pidgy extension
  3. ✏️ program in markdown

💡 try pidgy in jupyterlite without any installation1

programming in markdown

markdown is inclusive AF!2 it is a plain-text format that never fails 3. further markdown can include any programming language within its contents. effectively, markdown files are literate programs that really on code and narrative to cooperate. markdown is a global minimum for teams of people with different language literacies.

a Tab separates markdown code and narrative, pidgy uses this nearness to create python representations of the markdown. with code and narrative so close, an author can fluidly switch between the writing modes capturing more of their process.

learn more

development

Footnotes

  1. jupyterlite is a new in-the-browser jupyter experience that requires zero installation.

  2. there are techniques for improving accessibility of markdown and abiding best practices.

  3. markdown WILL violate expectation through implementation inconsistencies. over time we learn to navigate the nuances across products.