# md2pptx

**Repository Path**: xmx0632/md2pptx

## Basic Information

- **Project Name**: md2pptx
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-03
- **Last Updated**: 2025-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# md2pptx
Markdown to Powerpoint Converter

**Note:** md2pptx only supports Python 3. So the installation instructions are for that.

**Usage:**

  `python3 md2pptx output.pptx < input.markdown`

or

  `md2pptx output.pptx < input.markdown`


### Supported Python Releases

As was previously mentioned, Python 3 is required.

Specifically python-pptx

* requires 3.8 or later - to use the "Walrus Operator". From 1 April, 2025 md2pptx only supports 3.10 or later
* has been tested with 3.12 and alphas of 3.13 - with some changes made to handle issues

#### Future Python Release Support

Please note, and plan accordingly:

* From 1 April, 2026 expect releases to only support 3.11 or later
* From 1 April, 2027 expect releases to only support 3.12 or later

md2pptx moves forward on Python every so often to:

* Take advantage of new language capabilities
* Remain on a supported Python release with adequate fix likelihood.

### Installation

Installation is straightforward:

1. Install python-pptx
2. Clone md2pptx into a new directory

The md2pptx repo includes all the essentials, such as funnel.py. You don't install these with eg pip. There are some optional packages, outlined in the User Guide.

You can install python-pptx with

  `pip3 install python-pptx`

(On a Raspberry Pi you might want to use `pip3` (or `python3 -m pip`) to install for Python 3.)

You will probably need to issue the following command from the directory where you install it:

  `chmod +x md2pptx`

### Starting To Use md2pptx

I would also suggest you start with a presentation that references Martin Template.pptx in the metadata (before the first blank line). \
Here is a very simple deck that does exactly that.

```
template: Martin Template.pptx

# This Is A Presentation Title Page

## This Is A Presentation Section Page

### This Is A Bulleted List Page

* One
    * One A
    * One B
* Two

Here are some slide notes. Note you leave an empty line between the content - in this case a bulleted list - and the notes.

You can do multiple paragraphs and even use symbols.
```

### Documentation

As md2pptx has lots of function the documentation is a good place to discover it.

See `docs/user-guide.html` or `docs/user-guide.md`.

### Issues &amp; Suggestions

This repo's Issues are regularly monitored. Use them for bug reports, suggestions, and questions.