pidgy 2023.4.20

literate computing in python

pidgy literate computing interface

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 installation[^lite]

programming in markdown

markdown is inclusive AF![^a11y] it is a plain-text format that never fails [^violate]. 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

• try pidgy, without installing it, in jupyterlite.
• learn more from the pidgy documentation.
• learn how CommonMark markdown converts to python
• contributing and development

development

[^a11y]: there are techniques for improving accessibility of markdown and abiding best practices. [^violate]: markdown WILL violate expectation through implementation inconsistencies. over time we learn to navigate the nuances across products. [^lite]: jupyterlite is a new in-the-browser jupyter experience that requires zero installation.