notion-viewer

Name: notion-viewer
Availability: InStock
Author: paruma

Search Notion pages by title and render blocks as Markdown.

1|Updated Sep 5, 2021

Search Tags:#markdown #integration #cli #search #notion #notion-api #content-rendering

Ready to run

npx skills add https://github.com/paruma/atcoder_rust --skill notion-viewer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: notion-viewer
Source: https://github.com/paruma/atcoder_rust/tree/main/.gemini/skills/notion-viewer
Command: npx skills add https://github.com/paruma/atcoder_rust --skill notion-viewer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, python-dotenv, and includes scripts (resource) components.

What problem does it solve?

Notion pages often return verbose Notion API data. This skill searches Notion pages and renders their content in a human-friendly Markdown format, transforming complex JSON into readable output.

Core Features & Use Cases

Search: Locate pages by title and retrieve their IDs for quick access.
View Content: Render Notion blocks (text, headings, lists, tables) into clean Markdown for easy viewing.
CLI Workflow: Use a Python-based command-line interface with environment token management to interact with Notion.

Quick Start

Run the Notion Viewer to search for a page or to view a page's content. Example commands:

./scripts/notion_viewer.py search "Meeting notes"
./scripts/notion_viewer.py view "<Page-ID>"

Frequently Asked Questions about notion-viewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I convert Notion pages to Markdown using the API?▼

You can view Notion content as Markdown by providing a Page ID to the viewer. It retrieves the page blocks through the Notion API and translates text, headings, lists, and tables into formatted Markdown output.

Can I search for Notion pages by title through the command line?▼

Yes, the CLI supports searching Notion pages by title. Running the search command with a query string locates pages and returns their IDs, enabling quick retrieval for viewing or further processing.

Do I need a Notion API token to render page content in Markdown?▼

Yes, a Notion API token is required. The tool reads the NOTION_TOKEN from the environment using python-dotenv, so you must configure your Notion integration token before searching or viewing pages.

What is the best way to view Notion API JSON as readable text?▼

The best way to view Notion API JSON as readable text is using a rendering script that maps block types into structured Markdown. This tool converts verbose API responses into clean, human-friendly output.

Does this Notion Markdown viewer support rendering tables and lists?▼

Yes, the viewer supports rendering tables, lists, text, and headings. It uses a modular handler system to process various Notion block types and convert them into their corresponding Markdown syntax.