• 📊 Support for plots, widgets, and rich media
• 🎨 Customizable themes and layouts
• 📱 Responsive design for various screen sizes
• 📤 Export to HTML/PDF (limited content type)
• 🎯 Frame-by-frame animations
• 📝 Speaker notes support
• 🔄 Markdown, citations and settings files synchronization
• ✏️ Drawing support during presentations

1. Install:

pip install ipyslides        # Basic installation
pip install ipyslides[extra] # Full features

2. Create Slides:

import ipyslides as isd
slides = isd.Slides()

# Add content programmatically
slides.build(-1, """
# My First Slide
- Point 1
- Point 2
$E = mc^2$
""")

# Or use cell magic
%%slide 0
# Title Slide
Welcome to IPySlides!

3. Run Examples:

slides.docs()  # View documentation
slides.demo()  # See demo presentation

✨ Try it in your browser ✨

Jupyterlite	Binder

Support for various content types including:

• 📜 Extended Markdown, see slides.xmd_syntax
• 📊 Plots (Matplotlib, Plotly, Altair)
• 🔧 Interactive Widgets
• 📷 Images and Media
• ➗ LaTeX Equations
• ©️ Citations and References
• 💻 Auto update variables in markdown
• 🎥 Videos (YouTube, local)
• 🎮 Enhanced interactive widgets (with fullscreen support, thanks to anywidget)

import numpy as np
from ipywidgets import HTML

@slides.dl.interact(html = HTML(), amplitude= (0, 2),frequency=(0, 5))
def plot(html, amplitude, frequency):
    x = np.linspace(0, 2*np.pi, 100)
    y = amplitude * np.sin(frequency    * x)
    plt.plot(x, y)
    html.value = slides.plt2html(). value

• For comprehensive dashbords, subclass DashboardBase or use Dashboard from ipyslides.dashlab:

import numpy as np
import matplotlib.pyplot as plt
from ipywidgets import HTML
from ipyslides.dashlab import Dashboard

dash = Dashboard(
    html = HTML(),
    amplitude = (0, 2),
    frequency = (0, 5),
)

@dash.callback
def plot(self, html, amplitude, frequency):
    x = np.linspace(0, 2*np.pi, 100)
    y = amplitude * np.sin(frequency * x)
    plt.plot(x, y)
    html.value = slides.plt2html().value # can be directly shown on out-main

@dash.callback('out-text')
def text(self, amplitude, frequency):
    print(f"Amplitude: {amplitude}\n Frequency: {frequency}")

dash.set_layout( 
    left_sidebar = ['*ctrl'], # all controls in left sidebar 
    center = ['html','out-.*'], # out-main, out-text collected in center
    pane_widths = [3,5,0]
)
dash.set_css(
    main = { # can also be set via post_init callback
        'grid-gap': '4px', 'margin': '8px',
        '.left-sidebar': {'background': '#eee','border-radius': '8px'},
    },
    center = { # can be set in main through '> .center' selector
        '> *': {'background-color': 'whitesmoke', 'border-radius': '8px','padding':'8px'},
        'grid-template-columns': '5fr 3fr', # side-by-side layout for outputs
        'grid-gap': '4px', # central grid gap
        '> *': {'background-color': 'whitesmoke', 'border-radius': '8px','padding':'8px'}
})
display(dash)

See more examples in DashLab repository and try it out in

• And much more!

• HTML Export
  Use slides.export_html to build static slides that you can print as well. Read export details in settings panel, where you can also export with a single click.

• PDF Export

1. Export to HTML first
2. Open in Chrome/Edge browser
3. Use Print → Save as PDF and enable background graphics

Navigate to Documentation to see HTML slides which you can print to PDF.

• Custom Objects Serialization:

  • You can serialize custom objects to HTML using Slides.serializer API.
  • You can extend markdown syntax using Slides.extender API. See some good extensions to add from PyMdown.

• Speaker Notes: Enable via Settings Panel → Show Notes and add notes via slides.notes.

• Custom Styling:

slides.set_css({ # on all slides or slide[index,].set_css() per slide
    '--bg1-color': '#f0f0f0',
    '--text-color': '#333'
})

• File Sync: Live edit a linked markdown file that updates slides in real-time using slides.sync_with_file.

1. Markdown Cells:

   • Jupyter markdown cells are not processed by IPySlides
   • Instead, you can use %%slide number -m cell magic and link an external markdown file using slides.sync_with_file

2. Slide Numbering:

   • Use -1 for automatic slide numbering
   • Manual numbering requires careful tracking to avoid overwriting slides

3. Speaker Notes:

   • Experimental feature - use with caution

git clone https://github.com/asaboor-gh/ipyslides.git
cd ipyslides
pip install -e .

Contributions are welcome! Please feel free to submit a Pull Request.

• Github Pages Documentation
• Full documentation: slides.docs() same as on github pages.
• Examples: slides.demo()
• GitHub Repository

• ipywidgets & anywidget
• IPython
• Python-Markdown

Made with ❤️ by Abdul Saboor