Notion-DnD

A notion integration utility to build Notion databases and Markdown files.

This is a project I am working on in my free time as a way to learn python, seeing as there was no solid solution for D&D content I though to share it with everyone. I welcome any feedback or contributions!

If you do not wish to build your own database or to configure anything you can directly copy the Notion Database Here

Roadmap

• Build Notion databases from DND 5e API JSON files
• Generate Markdown files for each respective DnD resource
• Restructure JSON to easily support homebrew content
• Improve the markdown formatting
• Add more dynamic linking
• Provide AI API's integration to dynamically create pages based on AI requests
• D&D Beyond character import

Getting Started

Prerequisites

Developed with python 3.12.6, may work with other versions I have not tested it myself.

• Python 3.12.6
• Notion Client 2.2.1
• Required Python packages (listed in requirements.txt)

Installation

Clone the repository:

git clone https://github.com/yourusername/Notion-DnD.git
cd Notion-DnD

Install the required packages:

pip install -r requirements.txt

Usage

Integration Token

A Notion Integration Token, use Notion's Getting Started Guide to set one up.

Database ID

The database ID where you want the package, this is captured from your URL from Notion.so

• Example Page:
  • TestPage-1112508edf6680ab91b2c780935e857b
• Example Nested DB
  • 1112508edf668029ad26c7a557c042a7?v=422d58758f0348b3a12fe67abbc92cac

Execution

#Building the entire SRD
main.py --build all --database_id ***************** --auth_key secret_*****************

#Building the selected categories
main.py --build creatures weapons --database_id ***************** --auth_key secret_*****************

License

This project is licensed under the MIT License - see the LICENSE file for details. The underlying material is released using the Open Gaming License Version 1.0a

Contributing

All contributions are welcome!

1. Just fork this repository
2. Create a new branch for your work
3. Push up any changes to your branch, and open a pull request.

Acknowledgments

• notion-sdk-py: For its wonderful library making this project a breeze.
• 5e Bits and their 5e-database repo for providing the json data.