create-doc

Create Documentation

Create doc: $ARGUMENTS (title and content)

Using Notion MCP for knowledge management

Document Creation

1. Basic Page Creation

// Create simple page
await notion.pages.create({
  parent: { database_id: 'docs-database-id' },
  properties: {
    Name: { title: [{ text: { content: 'Getting Started Guide' } }] }
  },
  children: [
    {
      object: 'block',
      type: 'paragraph',
      paragraph: {
        rich_text: [{ type: 'text', text: { content: 'Welcome to our documentation!' } }]
      }
    }
  ]
});

2. Rich Content Pages

// Create page with multiple content types
await notion.pages.create({
  parent: { database_id: 'wiki-id' },
  properties: {
    Name: { title: [{ text: { content: 'API Documentation' } }] },
    Status: { select: { name: 'Published' } },
    Tags: { multi_select: [{ name: 'API' }, { name: 'Backend' }] }
  },
  children: [
    // Heading
    {
      heading_1: {
        rich_text: [{ text: { content: 'API Overview' } }]
      }
    },
    // Paragraph
    {
      paragraph: {
        rich_text: [{ text: { content: 'Our REST API provides...' } }]
      }
    },
    // Code block
    {
      code: {
        rich_text: [{ text: { content: 'GET /api/users' } }],
        language: 'javascript'
      }
    },
    // Bulleted list
    {
      bulleted_list_item: {
        rich_text: [{ text: { content: 'Authentication required' } }]
      }
    },
    // Callout (info box)
    {
      callout: {
        rich_text: [{ text: { content: '💡 Pro tip: Use API keys for authentication' } }],
        icon: { emoji: '💡' }
      }
    },
    // Toggle (collapsible)
    {
      toggle: {
        rich_text: [{ text: { content: 'View example response' } }],
        children: [
          {
            code: {
              rich_text: [{ text: { content: '{ "users": [...] }' } }],
              language: 'json'
            }
          }
        ]
      }
    }
  ]
});

3. Documentation from Code

// Generate docs from source code
async function generateAPIDocsFromCode(sourceFile) {
  const code = await readFile(sourceFile);
  const functions = parseAPIFunctions(code);

  for (const func of functions) {
    await notion.pages.create({
      parent: { database_id: 'api-docs-db' },
      properties: {
        Name: { title: [{ text: { content: func.name } }] },
        Method: { select: { name: func.method } },
        Endpoint: { rich_text: [{ text: { content: func.endpoint } }] }
      },
      children: [
        {
          heading_2: {
            rich_text: [{ text: { content: 'Description' } }]
          }
        },
        {
          paragraph: {
            rich_text: [{ text: { content: func.description } }]
          }
        },
        {
          heading_2: {
            rich_text: [{ text: { content: 'Parameters' } }]
          }
        },
        {
          code: {
            rich_text: [{ text: { content: JSON.stringify(func.params, null, 2) } }],
            language: 'json'
          }
        },
        {
          heading_2: {
            rich_text: [{ text: { content: 'Example' } }]
          }
        },
        {
          code: {
            rich_text: [{ text: { content: func.example } }],
            language: 'javascript'
          }
        }
      ]
    });
  }
}