Code blocks seem to be more or less the same as other, as I've been calling, "text-y" blocks. Except they include a "language" property after the list of rich text objects (still within the block[_type] property.

{
  "type": "code",
  //...other keys excluded
  "code": {
    "text": [{
      "type": "text",
      "text": {
        "content": "const a = 3"
      }
    }],
    "language": "javascript"
  }
}

Option 1

Maybe this is as simple as "enclosing" md_text by "```" and grabbing the "language"

md_text = f"```{block[_type]['language']}\n{md_text}\n```"

Image, video, and file blocks have the same structure

{
  "type": "image",
  //...other keys excluded
  "image": {
    "type": "external",
    "external": {
        "url": "https://website.domain/images/image.png"
    }
  }
}

https://developers.notion.com/reference/block#image-blocks

image blocks need to just produce ![Alt Text](url) markdown.

File and Video blocks might end up as regular links.

Per changes https://developers.notion.com/changelog/releasing-notion-version-2022-02-22

The text property in content blocks has been renamed to rich_text.

Probably something like this

if "bulleted_list" in _type:
        return “* “.join(_text_chunks)

technically, numbered list could be just “1. “ and markdown automatically understands them as n + 1

something like

from rich import print
print("hi")

ends up like

 from rich import print
print("hi")

because the " ".join(_text_chunks)

but just like we return on bookmarks we can return on the code blocks with "".join(_text_chunks)

If I'm putting a bookmark in Notion instead of a link I am expecting a new line. Bookmarks take a whole block in Notion so they clearly separate paragraph blocks in Notion. They should clearly separate paragraphs in markdown too.

Right now (version 0.1) writes markdown links with Alt text as the text by default.

A bookmark block looks like:

{
  "type": "bookmark",
  //...other keys excluded
  "bookmark": {
    "caption": "",
    "url": "https://website.domain"
  }
}

markdownify_block() right now builds the markdown string as

md_text = f"[Alt text]({_content['url']})"

Version 0.1 was focused on paragraph and heading_* blocks mostly so this was overlooked.

Option 1 (rejected)

was to use a bookmark's caption as the Alt text. This would require that we add captions to all bookmarks which is not something that's commonplace.

Option 2

is to "clean" the URL and use that as the Alt text. For example, "https://github.com/stedolan/jq/issues/124#issuecomment-17875972" would become "github.com/stedolan/jq/issues/124".

from urllib.parse import urlparse
# ...
_url = _content['url']
_, netloc, path, *_  = urlparse(_url)
md_text = f"[{netloc + path}]({_url})"

This way we're not obfuscating the link's destination.

Option 3 (maybe in the future)

We could ping the URL and extract the page's title and/or other info. This option may be cool to implement down the line but not right now.

The suggested code is

import requests
from bs4 import BeautifulSoup
from pypandoc import convert_text

# Replace with your own API key and page ID
api_key = 'your_api_key'
page_id = 'your_page_id'

# Construct the API endpoint for retrieving the page
endpoint = f'https://api.notion.com/v1/pages/{page_id}'

# Send the GET request to the API and retrieve the page
response = requests.get(endpoint, headers={
  'Authorization': f'Bearer {api_key}'
})

# Parse the page's properties from the API response
properties = response.json()['properties']

# Convert the page's contents to HTML
html = BeautifulSoup(properties['rich_text']['rich_text'], 'html.parser').prettify()

# Use pypandoc to convert the HTML to markdown
markdown = convert_text(html, 'html', 'markdown')

# Print the markdown to the console
print(markdown)

These are pretty simple blocks, just equation which we can just wrap between $ for markdown support

{
  "type": "equation",
  //...other keys excluded
  "equation": {
    
    "expression": "e=mc^2"
  }
}

Seems that embed blocks have the same structure as bookmark blocks

https://developers.notion.com/reference/block#embed-blocks

Just need to add corresponding tests and change the if statement to == bookmark or embed