This PR adds a comprehensive TypeScript example for creating "book mode" conference notes using the HackMD API. Book mode is a Markdown note system that contains organized links to individual session notes, making it easy for conference attendees to navigate between different sessions.

What's Added

New Example: examples/book-mode-conference/

• TypeScript Implementation: Full type safety with modern ES modules
• tsx Support: Direct execution without compilation using npm start
• Configurable Constants: All settings centralized at the top of the file for easy customization
• Comprehensive Documentation: Detailed comments explaining each function and section
• Sample Data: Realistic sessions.json with multi-day conference sessions
• Error Handling: Graceful handling of API failures during bulk operations

Key Features Demonstrated

1. Bulk Note Creation: Creates individual notes for each conference session
2. Team Note Management: Uses HackMD team API for organized note creation
3. Hierarchical Organization: Main book note organizes sessions by day and time
4. Template System: Customizable note templates with embedded announcements
5. Multilingual Support: Handles both English and Traditional Chinese sessions
6. Permission Management: Sets appropriate read/write permissions for collaboration

Usage Example

// Configuration constants at the top
const ANNOUNCEMENT_NOTE = '@DevOpsDay/rkO2jyLMlg'
const TEAM_PATH = 'DevOpsDay'
const CONFERENCE_CONFIG = {
  name: 'DevOpsDays Taipei 2025',
  website: 'https://devopsdays.tw/',
  // ...
}

// Run with: npm start

The script creates:

• Individual session notes with collaborative sections
• A main conference book linking to all sessions
• Organized navigation by day and time slots

Documentation

• Comprehensive README: Setup instructions, configuration guide, and troubleshooting
• Environment Configuration: .env.example with required API settings
• TypeScript Configuration: Proper tsconfig.json for ES modules
• Updated Main README: Added section describing the new example

This example showcases advanced HackMD API usage patterns including bulk operations, team note management, and creating interconnected note structures for conferences or events.

Fixes #39.

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.