skills.rest
paruma
parumaCOMMUNITY
Explore all skills by this author →
GitHub

notion-viewer

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
One-click install
npx skills add https://github.com/paruma/atcoder_rust --skill notion-viewer
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
zkcpkuzkcpku

notion

Create, retrieve, and modify Notion pages, databases, and blocks via API.

Community
Intermediate
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate
anthropicsanthropics
33.3k

MCP Integration

Integrate external services into Claude Code plugins via MCP.

Official
Intermediate
MOODMNKY-LLCMOODMNKY-LLC

notion

Automate Notion workspace management via CLI and REST API.

Community
Intermediate