confluence-cli 1.1.0 → 1.3.0

package/.github/workflows/ci.yml

@@ -64,5 +64,4 @@ jobs:
       uses: cycjimmy/semantic-release-action@v3
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
         NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -1,3 +1,59 @@
+# [1.3.0](https://github.com/pchuri/confluence-cli/compare/v1.2.0...v1.3.0) (2025-06-27)
+
+
+### Bug Fixes
+
+* improve format handling based on production testing ([820f9cd](https://github.com/pchuri/confluence-cli/commit/820f9cdc7e59b6aa4b676eda6cff7e22865ec8fb))
+
+
+### Features
+
+* implement page creation and update capabilities ([3c43b19](https://github.com/pchuri/confluence-cli/commit/3c43b19765f94318d01fea3a22b324ada00a77d1))
+
+# [1.2.1](https://github.com/pchuri/confluence-cli/compare/v1.2.0...v1.2.1) (2025-06-27)
+
+
+### Bug Fixes
+
+* **format handling**: improve compatibility across Confluence instances
+  - Switch from 'html' macro to 'markdown' macro for better compatibility
+  - Change HTML processing to direct Storage format (no macro wrapper)
+  - Add markdownToNativeStorage method for alternative conversion
+  - Fix issues discovered during production testing in real Confluence environments
+
+# [1.2.0](https://github.com/pchuri/confluence-cli/compare/v1.1.0...v1.2.0) (2025-06-27)
+
+
+### Features
+
+* implement page creation and update capabilities ([#2](https://github.com/pchuri/confluence-cli/issues/2)) ([b814ddf](https://github.com/pchuri/confluence-cli/commit/b814ddfd056aeac83cc7eb5d8d6db47ba9c70cdf))
+
+# [1.2.0](https://github.com/pchuri/confluence-cli/compare/v1.1.0...v1.2.0) (2025-06-27)
+
+
+### Features
+
+* **page management**: add page creation and update capabilities ([NEW])
+  - `confluence create` - Create new pages with support for Markdown, HTML, and Storage formats
+  - `confluence update` - Update existing page content and titles
+  - `confluence edit` - Export page content for editing workflow
+  - Support for reading content from files or inline
+  - Markdown to Confluence Storage format conversion
+* **content formats**: support multiple input formats
+<<<<<<< HEAD
+  - Markdown format with automatic conversion using `markdown` macro
+  - HTML format with direct Storage format integration
+=======
+  - Markdown format with automatic conversion
+  - HTML format with Storage format wrapping
+>>>>>>> origin/main
+  - Native Confluence Storage format
+* **examples**: add sample files and demo scripts for new features
+
+### Breaking Changes
+
+* None - all new features are additive
+
 # [1.1.0](https://github.com/pchuri/confluence-cli/compare/v1.0.0...v1.1.0) (2025-06-26)
 
 

package/README.md

@@ -8,6 +8,9 @@ A powerful command-line interface for Atlassian Confluence that allows you to re
 - 🔍 **Search** - Find pages using Confluence's powerful search
 - ℹ️ **Page info** - Get detailed information about pages
 - 🏠 **List spaces** - View all available Confluence spaces
+- ✏️ **Create pages** - Create new pages with support for Markdown, HTML, or Storage format
+- 📝 **Update pages** - Update existing page content and titles
+- 🛠️ **Edit workflow** - Export page content for editing and re-import
 - 🔧 **Easy setup** - Simple configuration with environment variables or interactive setup
 
 ## Installation
@@ -38,6 +41,16 @@ npx confluence-cli
    confluence search "my search term"
    ```
 
+4. **Create a new page:**
+   ```bash
+   confluence create "My New Page" SPACEKEY --content "Hello World!"
+   ```
+
+5. **Update a page:**
+   ```bash
+   confluence update 123456789 --content "Updated content"
+   ```
+
 ## Configuration
 
 ### Option 1: Interactive Setup
@@ -65,6 +78,79 @@ export CONFLUENCE_API_TOKEN="your-api-token"
 # Read by page ID
 confluence read 123456789
 
+# Read in HTML format
+confluence read 123456789 --format html
+
+# Read by URL
+confluence read "https://your-domain.atlassian.net/wiki/spaces/SPACE/pages/123456789/Page+Title"
+```
+
+### Create a New Page
+```bash
+# Create with inline content
+confluence create "My New Page" SPACEKEY --content "This is my page content"
+
+# Create from a file
+confluence create "Documentation" SPACEKEY --file ./content.md --format markdown
+
+# Create with HTML content
+confluence create "Rich Content" SPACEKEY --file ./content.html --format html
+
+# Create with Storage format (Confluence native)
+confluence create "Advanced Page" SPACEKEY --file ./content.xml --format storage
+```
+
+### Create a Child Page
+```bash
+# Find parent page first
+confluence find "Project Documentation" --space MYTEAM
+
+# Create child page with inline content
+confluence create-child "Meeting Notes" 123456789 --content "This is a child page"
+
+# Create child page from file
+confluence create-child "Technical Specifications" 123456789 --file ./content.md --format markdown
+
+# Create child page with HTML content
+confluence create-child "Report Summary" 123456789 --file ./content.html --format html
+```
+
+### Find Pages
+```bash
+# Find page by title
+confluence find "Project Documentation"
+
+# Find page by title in specific space
+confluence find "Project Documentation" --space MYTEAM
+```
+
+### Update an Existing Page
+```bash
+# Update content only
+confluence update 123456789 --content "Updated content"
+
+# Update content from file
+confluence update 123456789 --file ./updated-content.md --format markdown
+
+# Update both title and content
+confluence update 123456789 --title "New Title" --content "New content"
+
+# Update from HTML file
+confluence update 123456789 --file ./content.html --format html
+```
+
+### Edit Workflow
+```bash
+# Export page content for editing
+confluence edit 123456789 --output ./page-content.xml
+
+# Edit the file with your preferred editor
+vim ./page-content.xml
+
+# Update the page with your changes
+confluence update 123456789 --file ./page-content.xml --format storage
+```
+
 # Read with HTML format
 confluence read 123456789 --format html
 
@@ -166,7 +252,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## Roadmap
 
-- [ ] Create and update pages
+- [x] **Create and update pages** ✅
 - [ ] Page templates
 - [ ] Bulk operations
 - [ ] Export pages to different formats

package/bin/confluence.js

@@ -135,4 +135,202 @@ program
     }
   });
 
+// Create command
+program
+  .command('create <title> <spaceKey>')
+  .description('Create a new Confluence page')
+  .option('-f, --file <file>', 'Read content from file')
+  .option('-c, --content <content>', 'Page content as string')
+  .option('--format <format>', 'Content format (storage, html, markdown)', 'storage')
+  .action(async (title, spaceKey, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      
+      let content = '';
+      
+      if (options.file) {
+        const fs = require('fs');
+        if (!fs.existsSync(options.file)) {
+          throw new Error(`File not found: ${options.file}`);
+        }
+        content = fs.readFileSync(options.file, 'utf8');
+      } else if (options.content) {
+        content = options.content;
+      } else {
+        throw new Error('Either --file or --content option is required');
+      }
+      
+      const result = await client.createPage(title, spaceKey, content, options.format);
+      
+      console.log(chalk.green('✅ Page created successfully!'));
+      console.log(`Title: ${chalk.blue(result.title)}`);
+      console.log(`ID: ${chalk.blue(result.id)}`);
+      console.log(`Space: ${chalk.blue(result.space.name)} (${result.space.key})`);
+      console.log(`URL: ${chalk.gray(`https://${config.domain}/wiki${result._links.webui}`)}`);
+      
+      analytics.track('create', true);
+    } catch (error) {
+      analytics.track('create', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Create child page command
+program
+  .command('create-child <title> <parentId>')
+  .description('Create a new Confluence page as a child of another page')
+  .option('-f, --file <file>', 'Read content from file')
+  .option('-c, --content <content>', 'Page content as string')
+  .option('--format <format>', 'Content format (storage, html, markdown)', 'storage')
+  .action(async (title, parentId, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      
+      // Get parent page info to get space key
+      const parentInfo = await client.getPageInfo(parentId);
+      const spaceKey = parentInfo.space.key;
+      
+      let content = '';
+      
+      if (options.file) {
+        const fs = require('fs');
+        if (!fs.existsSync(options.file)) {
+          throw new Error(`File not found: ${options.file}`);
+        }
+        content = fs.readFileSync(options.file, 'utf8');
+      } else if (options.content) {
+        content = options.content;
+      } else {
+        throw new Error('Either --file or --content option is required');
+      }
+      
+      const result = await client.createChildPage(title, spaceKey, parentId, content, options.format);
+      
+      console.log(chalk.green('✅ Child page created successfully!'));
+      console.log(`Title: ${chalk.blue(result.title)}`);
+      console.log(`ID: ${chalk.blue(result.id)}`);
+      console.log(`Parent: ${chalk.blue(parentInfo.title)} (${parentId})`);
+      console.log(`Space: ${chalk.blue(result.space.name)} (${result.space.key})`);
+      console.log(`URL: ${chalk.gray(`https://${config.domain}/wiki${result._links.webui}`)}`);
+      
+      analytics.track('create_child', true);
+    } catch (error) {
+      analytics.track('create_child', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Update command
+program
+  .command('update <pageId>')
+  .description('Update an existing Confluence page')
+  .option('-t, --title <title>', 'New page title (optional)')
+  .option('-f, --file <file>', 'Read content from file')
+  .option('-c, --content <content>', 'Page content as string')
+  .option('--format <format>', 'Content format (storage, html, markdown)', 'storage')
+  .action(async (pageId, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      
+      let content = '';
+      
+      if (options.file) {
+        const fs = require('fs');
+        if (!fs.existsSync(options.file)) {
+          throw new Error(`File not found: ${options.file}`);
+        }
+        content = fs.readFileSync(options.file, 'utf8');
+      } else if (options.content) {
+        content = options.content;
+      } else {
+        throw new Error('Either --file or --content option is required');
+      }
+      
+      const result = await client.updatePage(pageId, options.title, content, options.format);
+      
+      console.log(chalk.green('✅ Page updated successfully!'));
+      console.log(`Title: ${chalk.blue(result.title)}`);
+      console.log(`ID: ${chalk.blue(result.id)}`);
+      console.log(`Version: ${chalk.blue(result.version.number)}`);
+      console.log(`URL: ${chalk.gray(`https://${config.domain}/wiki${result._links.webui}`)}`);
+      
+      analytics.track('update', true);
+    } catch (error) {
+      analytics.track('update', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Edit command - opens page content for editing
+program
+  .command('edit <pageId>')
+  .description('Get page content for editing')
+  .option('-o, --output <file>', 'Save content to file')
+  .action(async (pageId, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      const pageData = await client.getPageForEdit(pageId);
+      
+      console.log(chalk.blue('Page Information:'));
+      console.log(`Title: ${chalk.green(pageData.title)}`);
+      console.log(`ID: ${chalk.green(pageData.id)}`);
+      console.log(`Version: ${chalk.green(pageData.version)}`);
+      console.log(`Space: ${chalk.green(pageData.space.name)} (${pageData.space.key})`);
+      console.log('');
+      
+      if (options.output) {
+        const fs = require('fs');
+        fs.writeFileSync(options.output, pageData.content);
+        console.log(chalk.green(`✅ Content saved to: ${options.output}`));
+        console.log(chalk.yellow('💡 Edit the file and use "confluence update" to save changes'));
+      } else {
+        console.log(chalk.blue('Page Content:'));
+        console.log(pageData.content);
+      }
+      
+      analytics.track('edit', true);
+    } catch (error) {
+      analytics.track('edit', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Find page by title command
+program
+  .command('find <title>')
+  .description('Find a page by title')
+  .option('-s, --space <spaceKey>', 'Limit search to specific space')
+  .action(async (title, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      const pageInfo = await client.findPageByTitle(title, options.space);
+      
+      console.log(chalk.blue('Page found:'));
+      console.log(`Title: ${chalk.green(pageInfo.title)}`);
+      console.log(`ID: ${chalk.green(pageInfo.id)}`);
+      console.log(`Space: ${chalk.green(pageInfo.space.name)} (${pageInfo.space.key})`);
+      console.log(`URL: ${chalk.gray(`https://${config.domain}/wiki${pageInfo.url}`)}`);
+      
+      analytics.track('find', true);
+    } catch (error) {
+      analytics.track('find', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
 program.parse();

package/examples/create-child-page-example.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+
+# 실제 Project Documentation 페이지 하위에 테스트 페이지 생성 예제
+# 이 스크립트는 일반적인 Confluence 설정에서 작동합니다.
+
+echo "🔍 Project Documentation 페이지 하위에 테스트 페이지 생성"
+echo "=============================================================="
+
+# 1단계: 부모 페이지 찾기
+echo ""
+echo "1️⃣ 부모 페이지 찾기..."
+echo "실행: confluence find \"Project Documentation\" --space MYTEAM"
+echo ""
+
+# 실제 실행할 때는 아래 주석을 해제하세요
+# confluence find "Project Documentation" --space MYTEAM
+
+echo "📝 위 명령어 결과에서 페이지 ID를 확인하세요 (예: 123456789)"
+echo ""
+
+# 2단계: 페이지 정보 확인
+echo "2️⃣ 페이지 정보 확인..."
+echo "실행: confluence info [페이지ID]"
+echo "예시: confluence info 123456789"
+echo ""
+
+# 3단계: 페이지 내용 읽기 (선택사항)
+echo "3️⃣ 페이지 내용 확인 (선택사항)..."
+echo "실행: confluence read [페이지ID] | head -20"
+echo "예시: confluence read 123456789 | head -20"
+echo ""
+
+# 4단계: 테스트 페이지 생성
+echo "4️⃣ 하위 테스트 페이지 생성..."
+echo ""
+
+# 간단한 텍스트 콘텐츠로 테스트 페이지 생성
+echo "📄 방법 1: 간단한 텍스트 콘텐츠로 생성"
+echo 'confluence create-child "Test Page - $(date +%Y%m%d)" [부모페이지ID] --content "이것은 CLI로 생성된 테스트 페이지입니다. 생성 시간: $(date)"'
+echo ""
+
+# 마크다운 파일에서 테스트 페이지 생성
+echo "📄 방법 2: 마크다운 파일에서 생성"
+echo "confluence create-child \"Test Documentation - $(date +%Y%m%d)\" [부모페이지ID] --file ./sample-page.md --format markdown"
+echo ""
+
+# HTML 콘텐츠로 생성
+echo "📄 방법 3: HTML 콘텐츠로 생성"
+echo 'confluence create-child "Test HTML Page" [부모페이지ID] --content "<h1>테스트 페이지</h1><p>이것은 <strong>HTML</strong>로 작성된 테스트 페이지입니다.</p>" --format html'
+echo ""
+
+echo "💡 실제 사용 예제:"
+echo "=============================="
+echo "# 1. 부모 페이지 ID 찾기"
+echo 'PARENT_ID=$(confluence find "Project Documentation" --space MYTEAM | grep "ID:" | cut -d" " -f2)'
+echo ""
+echo "# 2. 테스트 페이지 생성"
+echo 'confluence create-child "테스트 페이지 - $(date +%Y%m%d_%H%M)" $PARENT_ID --content "CLI 테스트용 페이지입니다."'
+echo ""
+
+echo "⚠️  주의사항:"
+echo "- confluence CLI가 올바르게 설정되어 있어야 합니다 (confluence init)"
+echo "- 해당 Confluence 인스턴스에 대한 적절한 권한이 있어야 합니다"
+echo "- 페이지 생성 권한이 있는지 확인하세요"
+echo "- 테스트 후에는 불필요한 페이지를 정리하세요"

package/examples/demo-page-management.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+
+# Confluence CLI Demo Script
+# This script demonstrates the new page creation and update features
+
+echo "🚀 Confluence CLI - Page Creation Demo"
+echo "======================================"
+
+# Note: Replace with your actual space key and ensure you have confluence-cli configured
+SPACE_KEY="MYTEAM"  # Change this to your space key
+
+echo ""
+echo "1. Creating a page from Markdown file..."
+echo "confluence create \"Sample Page from CLI\" $SPACE_KEY --file ./sample-page.md --format markdown"
+
+echo ""
+echo "2. Creating a page with inline content..."
+echo "confluence create \"Quick Note\" $SPACE_KEY --content \"This is a quick note created from the CLI\" --format storage"
+
+echo ""
+echo "3. Updating a page (replace 123456789 with actual page ID)..."
+echo "confluence update 123456789 --content \"This page has been updated via CLI\""
+
+echo ""
+echo "4. Getting page content for editing..."
+echo "confluence edit 123456789 --output ./page-backup.xml"
+
+echo ""
+echo "5. Searching for pages..."
+echo "confluence search \"CLI\""
+
+echo ""
+echo "6. Listing all spaces..."
+echo "confluence spaces"
+
+echo ""
+echo "7. Finding a page by title..."
+echo "confluence find \"Project Documentation\" --space MYTEAM"
+
+echo ""
+echo "8. Creating a child page under a parent page..."
+echo "confluence create-child \"Test Page\" 123456789 --content \"This is a test page created as a child\""
+
+echo ""
+echo "9. Creating a child page from Markdown file..."
+echo "confluence create-child \"Test Documentation\" 123456789 --file ./sample-page.md --format markdown"
+
+echo ""
+echo "💡 Tips:"
+echo "- Use --format markdown to create pages from Markdown files"
+echo "- Use --format html for HTML content"
+echo "- Use --format storage for Confluence native format"
+echo "- Always backup important pages before updating"
+echo "- Use 'confluence find' to get page IDs by title"
+echo "- Child pages inherit permissions from their parent"
+
+echo ""
+echo "📝 Edit workflow:"
+echo "1. confluence edit [pageId] --output page.xml"
+echo "2. Edit the file with your preferred editor"
+echo "3. confluence update [pageId] --file page.xml --format storage"
+
+echo ""
+echo "🔍 Finding and creating child pages workflow:"
+echo "1. confluence find \"Project Documentation\" --space MYTEAM"
+echo "2. Note the page ID from the result"
+echo "3. confluence create-child \"Meeting Notes\" [parentId] --content \"Child content\""
+echo "4. Or use: confluence create-child \"Technical Docs\" [parentId] --file ./content.md --format markdown"

package/examples/sample-page.md

@@ -0,0 +1,30 @@
+# Welcome to Confluence CLI
+
+This is a sample page created using the **Confluence CLI** tool.
+
+## Features
+
+- Easy page creation from Markdown files
+- Support for multiple content formats
+- Command-line interface for automation
+
+## Code Example
+
+```javascript
+const client = new ConfluenceClient(config);
+await client.createPage('My Page', 'SPACE', content, 'markdown');
+```
+
+## Lists
+
+1. First item
+2. Second item
+3. Third item
+
+- Bullet point one
+- Bullet point two
+- Bullet point three
+
+---
+
+*Created with ❤️ using confluence-cli*

package/lib/confluence-client.js

@@ -1,11 +1,13 @@
 const axios = require('axios');
 const { convert } = require('html-to-text');
+const MarkdownIt = require('markdown-it');
 
 class ConfluenceClient {
   constructor(config) {
     this.baseURL = `https://${config.domain}/rest/api`;
     this.token = config.token;
     this.domain = config.domain;
+    this.markdown = new MarkdownIt();
     
     this.client = axios.create({
       baseURL: this.baseURL,
@@ -132,6 +134,210 @@ class ConfluenceClient {
       type: space.type
     }));
   }
+
+  /**
+   * Convert markdown to Confluence storage format
+   */
+  markdownToStorage(markdown) {
+    // Use Confluence's markdown macro instead of HTML
+    return `<ac:structured-macro ac:name="markdown">
+      <ac:parameter ac:name="atlassian-macro-output-type">BLOCK</ac:parameter>
+      <ac:plain-text-body><![CDATA[${markdown}]]></ac:plain-text-body>
+    </ac:structured-macro>`;
+  }
+
+  /**
+   * Convert markdown to Confluence storage format using native storage format
+   */
+  markdownToNativeStorage(markdown) {
+    // Convert markdown to HTML first
+    const html = this.markdown.render(markdown);
+    
+    // Simple HTML to Storage format conversion
+    // This is a basic implementation - for full support, we'd need a more sophisticated converter
+    let storage = html
+      .replace(/<h1>/g, '<h1>')
+      .replace(/<\/h1>/g, '</h1>')
+      .replace(/<h2>/g, '<h2>')
+      .replace(/<\/h2>/g, '</h2>')
+      .replace(/<h3>/g, '<h3>')
+      .replace(/<\/h3>/g, '</h3>')
+      .replace(/<p>/g, '<p>')
+      .replace(/<\/p>/g, '</p>')
+      .replace(/<strong>/g, '<strong>')
+      .replace(/<\/strong>/g, '</strong>')
+      .replace(/<em>/g, '<em>')
+      .replace(/<\/em>/g, '</em>')
+      .replace(/<ul>/g, '<ul>')
+      .replace(/<\/ul>/g, '</ul>')
+      .replace(/<ol>/g, '<ol>')
+      .replace(/<\/ol>/g, '</ol>')
+      .replace(/<li>/g, '<li>')
+      .replace(/<\/li>/g, '</li>')
+      .replace(/<code>/g, '<code>')
+      .replace(/<\/code>/g, '</code>')
+      .replace(/<pre><code>/g, '<ac:structured-macro ac:name="code"><ac:plain-text-body><![CDATA[')
+      .replace(/<\/code><\/pre>/g, ']]></ac:plain-text-body></ac:structured-macro>');
+    
+    return storage;
+  }
+
+  /**
+   * Create a new Confluence page
+   */
+  async createPage(title, spaceKey, content, format = 'storage') {
+    let storageContent = content;
+    
+    if (format === 'markdown') {
+      storageContent = this.markdownToStorage(content);
+    } else if (format === 'html') {
+      // Convert HTML directly to storage format (no macro wrapper)
+      storageContent = content;
+    }
+
+    const pageData = {
+      type: 'page',
+      title: title,
+      space: {
+        key: spaceKey
+      },
+      body: {
+        storage: {
+          value: storageContent,
+          representation: 'storage'
+        }
+      }
+    };
+
+    const response = await this.client.post('/content', pageData);
+    return response.data;
+  }
+
+  /**
+   * Create a new Confluence page as a child of another page
+   */
+  async createChildPage(title, spaceKey, parentId, content, format = 'storage') {
+    let storageContent = content;
+    
+    if (format === 'markdown') {
+      storageContent = this.markdownToStorage(content);
+    } else if (format === 'html') {
+      // Convert HTML directly to storage format (no macro wrapper)
+      storageContent = content;
+    }
+
+    const pageData = {
+      type: 'page',
+      title: title,
+      space: {
+        key: spaceKey
+      },
+      ancestors: [
+        {
+          id: parentId
+        }
+      ],
+      body: {
+        storage: {
+          value: storageContent,
+          representation: 'storage'
+        }
+      }
+    };
+
+    const response = await this.client.post('/content', pageData);
+    return response.data;
+  }
+
+  /**
+   * Update an existing Confluence page
+   */
+  async updatePage(pageId, title, content, format = 'storage') {
+    // First, get the current page to get the version number
+    const currentPage = await this.client.get(`/content/${pageId}`);
+    const currentVersion = currentPage.data.version.number;
+
+    let storageContent = content;
+    
+    if (format === 'markdown') {
+      storageContent = this.markdownToStorage(content);
+    } else if (format === 'html') {
+      // Convert HTML directly to storage format (no macro wrapper)
+      storageContent = content;
+    }
+
+    const pageData = {
+      id: pageId,
+      type: 'page',
+      title: title || currentPage.data.title,
+      space: currentPage.data.space,
+      body: {
+        storage: {
+          value: storageContent,
+          representation: 'storage'
+        }
+      },
+      version: {
+        number: currentVersion + 1
+      }
+    };
+
+    const response = await this.client.put(`/content/${pageId}`, pageData);
+    return response.data;
+  }
+
+  /**
+   * Get page content for editing
+   */
+  async getPageForEdit(pageIdOrUrl) {
+    const pageId = this.extractPageId(pageIdOrUrl);
+    
+    const response = await this.client.get(`/content/${pageId}`, {
+      params: {
+        expand: 'body.storage,version,space'
+      }
+    });
+
+    return {
+      id: response.data.id,
+      title: response.data.title,
+      content: response.data.body.storage.value,
+      version: response.data.version.number,
+      space: response.data.space
+    };
+  }
+
+  /**
+   * Search for a page by title and space
+   */
+  async findPageByTitle(title, spaceKey = null) {
+    let cql = `title = "${title}"`;
+    if (spaceKey) {
+      cql += ` AND space = "${spaceKey}"`;
+    }
+
+    const response = await this.client.get('/search', {
+      params: {
+        cql: cql,
+        limit: 1,
+        expand: 'content.space'
+      }
+    });
+
+    if (response.data.results.length === 0) {
+      throw new Error(`Page not found: "${title}"`);
+    }
+
+    const result = response.data.results[0];
+    const content = result.content || result;
+    
+    return {
+      id: content.id,
+      title: content.title,
+      space: content.space || { key: spaceKey || 'Unknown', name: 'Unknown' },
+      url: content._links?.webui || ''
+    };
+  }
 }
 
 module.exports = ConfluenceClient;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "confluence-cli",
-  "version": "1.1.0",
-  "description": "A command-line interface for Atlassian Confluence",
+  "version": "1.3.0",
+  "description": "A command-line interface for Atlassian Confluence with page creation and editing capabilities",
   "main": "index.js",
   "bin": {
     "confluence": "bin/index.js"
@@ -22,17 +22,18 @@
   "author": "Your Name",
   "license": "MIT",
   "dependencies": {
-    "commander": "^11.1.0",
     "axios": "^1.6.2",
     "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "html-to-text": "^9.0.5",
     "inquirer": "^8.2.6",
-    "ora": "^5.4.1",
-    "html-to-text": "^9.0.5"
+    "markdown-it": "^14.1.0",
+    "ora": "^5.4.1"
   },
   "devDependencies": {
+    "@types/node": "^20.10.0",
     "eslint": "^8.55.0",
-    "jest": "^29.7.0",
-    "@types/node": "^20.10.0"
+    "jest": "^29.7.0"
   },
   "engines": {
     "node": ">=14.0.0"

package/tests/confluence-client.test.js

@@ -26,4 +26,25 @@ describe('ConfluenceClient', () => {
       expect(() => client.extractPageId(displayUrl)).toThrow('Display URLs not yet supported');
     });
   });
+
+  describe('markdownToStorage', () => {
+    test('should convert markdown to Confluence storage format', () => {
+      const markdown = '# Hello World\n\nThis is a **test** page.';
+      const result = client.markdownToStorage(markdown);
+      
+      expect(result).toContain('<ac:structured-macro ac:name="markdown">');
+      expect(result).toContain('Hello World');
+      expect(result).toContain('**test**');
+    });
+  });
+
+  describe('page creation and updates', () => {
+    test('should have required methods for page management', () => {
+      expect(typeof client.createPage).toBe('function');
+      expect(typeof client.updatePage).toBe('function');
+      expect(typeof client.getPageForEdit).toBe('function');
+      expect(typeof client.createChildPage).toBe('function');
+      expect(typeof client.findPageByTitle).toBe('function');
+    });
+  });
 });