GitXplorerGitXplorer
m

md2notion

public
5 stars
1 forks
3 issues

Commits

List of commits on branch main.
Unverified
11bd184ca86482f200ff51060e291dd5492dd0a7

correct cli read file encoding to utf8

mmarkomanninen committed a year ago
Unverified
a461f7f2c5177d32d4d2e3958172af12f7eb61e8

Added wide support for md formated text

mmarkomanninen committed a year ago
Unverified
3fa470453a7d6d5592ea6eed7a18c3e264d9bad6

Merge branch 'main' of https://github.com/markomanninen/md2notion

mmarkomanninen committed a year ago
Unverified
0825257d6ef50416054cd145c4f355da3684a4f8

changed example url

mmarkomanninen committed a year ago
Unverified
80f8aba6ce76121abeb369526692353cceca91c6

Merge changes from upstream remote

committed a year ago
Unverified
78b83c7c915a70005029888dc46221f8374660e9

Commit from Noteable

committed a year ago

README

The README file for this repository.

md2notionpage

A Python package to convert Markdown text into Notion pages. This module provides functionality to create Notion pages from Markdown text, parse Markdown into Notion blocks, and process inline formatting.

Installation

You can install the package using pip:

pip install md2notionpage

Usage

Here's a basic example of how to use the md2notionpage function:

from md2notionpage import md2notionpage

markdown_text = """
# My Page
This is a Notion page created from Markdown content.
"""

title = 'My Notion Page'

parent_page_id = 'YOUR_PARENT_PAGE_ID'

notion_page_url = md2notionpage(markdown_text, title, parent_page_id)

Supported Markdown Features

Headings

You can create headings using the # symbol. The number of # symbols determines the level of the heading:

# Heading Level 1
## Heading Level 2
### Heading Level 3

Text Formatting

  • Bold Text: You can create bold text using ** or __.
  • Italic Text: You can create italic text using * or _.
  • Bold and Italic: You can combine bold and italic using __* or **_.
  • Strikethrough: You can strikethrough text using ~.
  • Inline Code: You can create inline code using backticks `.
  • Inline Latex: You can create inline latex using $.

Latex Block

You can create a Latex block using $$:

$$
x = \sqrt{y^2 + z^2}
$$

Lists

  • Unordered List: You can create an unordered list using -.
  • Ordered List: You can create an ordered list using numbers followed by a dot 1..

Links

You can create links using [link text](url).

Indented Code

You can create indented code using four spaces:

    def hello_world():
        print("Hello, world!")

Code Block

You can create a code block using triple backticks:

```python
def hello_world2():
    print("Hello, world2!")
```

Blockquote

You can create a blockquote using >:

> Quote text

Tables

You can create tables with or without header rows. They will become LaTeX/KaTeX tables in the Notion page.

Table with Headers

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Content  | Content  | Content  |

Table without Headers

| Content 1.1 | Content 2.1 | Content 3.1 |
| Content 1.2 | Content 2.2 | Content 3.2 |

Horizontal Line

You can create a horizontal line using three or more dashes ---.

Images

You can insert images with or without alt text:

With Alt Text:

![Alt Text](https://raw.githubusercontent.com/markomanninen/md2notion/main/photo-1501504905252-473c47e087f8.jpeg)

Alt gives an image caption in Notion.

Without Alt Text:

![](https://raw.githubusercontent.com/markomanninen/md2notion/main/photo-1501504905252-473c47e087f8.jpeg)

Nested Lists

You can create nested lists by indenting sub-items:

  1. Item 1
    1. Sub-item 1
    2. Sub-item 2
      1. Sub-sub-item 1
      2. Sub-sub-item 2
  2. Item 2

Similarly unordered lists are supported.

Dependencies

  • notion-client

Environment Variables

You must set the NOTION_SECRET environment variable with your Notion API token.

Notes

This package is designed to work with the Notion API and requires proper authentication. Make sure to follow Notion's API documentation to set up your integration.

Development

  1. Use .env to setup NOTION_SECRET and NOTION_PARENT_PAGE_ID
  2. Run tests: python -m unittest discover tests
  3. When tests are ok, commit changes

Package control

Change to next version number in setup.py

  1. Create wheels: python setup.py sdist bdist_wheel
  2. Deploy: python -m twine upload dist/*

License

This project is licensed under the MIT License. See the LICENSE file for details.