Section Markdown Page

You can use a .md file as a regular Jupyter Book page.

Why This Matters¶

• Not every page needs executable cells.

• Markdown pages are lightweight and fast to maintain.

• Great for overview pages, guides, FAQ, and release notes.

MyST Features Demo¶

MyST Markdown adds several website-aware enhancements beyond plain markdown. Use these features in .md pages and they will render on the Jupyter Book website.

Admonitions¶

MyST admonitions are a great way to add callouts, tips, warnings, and notes.

This warning block is usually visible on the built site but may not appear correctly in simple markdown previews.

Cross references¶

You can reference sections, figures, and pages directly from the site.

See the MyST docs for examples.

Task lists¶

• Task one

• Task two

• Task three

Definition list¶

Term

Definition text that explains the term.

Inline math¶

Set notation example: $S = \{x \in \mathbb{R} : x^2 > 0\}$

Code block with syntax highlighting¶

print('MyST pages can still show code, and code blocks render on the website.')

Visibility Note¶

Some MyST-specific features may not render exactly in a plain markdown preview. They are designed for the Jupyter Book website and will look correct after site build.

Interactive Components Showcase¶

This template demonstrates interactive components supported by Jupyter Book and MyST Markdown. These features help create clean, interactive, and user-friendly documentation.

Dropdown Example (Click to Expand / Hide Content)¶

Toggle (Collapsible Dropdown)¶

Admonition Dropdown (Professional Style)¶

Tabs Example¶

print("Hello from Python")

# Hello from Markdown
This content is rendered as markdown on the built website.

Wikipedia Popup Example¶

Tooltip Example¶

This template supports glossary tooltips like Jupyter Book.

Callout Example¶

print("Hello Pyodide")