byvfx/go-notion-md-sync v0.10.0

on GitHub

No release notes found for v0.10.0.# v0.10.0 - Feature Completeness (Phase 2)

Released: July 2025

🎉 Major Features

This release completes Phase 2: Feature Completeness from our roadmap, adding comprehensive support for advanced Notion blocks, enhanced markdown features, and powerful database operations.

🖼️ Extended Notion Block Support

• Images: Full support for image blocks with captions and external URLs
• Callouts: Convert blockquotes with emoji prefixes to Notion callout blocks
• Toggles: Collapsible sections using HTML details/summary syntax
• Bookmarks: Link blocks with rich preview support
• Dividers: Horizontal rule conversion (--- to divider blocks)
• Nested Lists: Unlimited depth for both bulleted and numbered lists

🧮 LaTeX Math Equations

• Full support for mathematical expressions using $$ delimiters
• Block-level equations with proper Notion equation block conversion
• Handles complex multi-line equations with \begin{aligned}...\end{aligned}
• Bidirectional sync preserves equation formatting

Example:

$$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$

📊 Mermaid Diagram Support

• Preserves Mermaid diagrams as code blocks with language: "mermaid"
• Maintains diagram structure during bidirectional sync
• Full compatibility with Notion's code block rendering

🗄️ CSV/Database Integration

New database command with powerful operations:

• Export: Convert Notion databases to CSV format
• Import: Update existing databases from CSV files
• Create: Generate new Notion databases from CSV structure
• Smart type inference for CSV columns
• Handles all common Notion property types (text, number, select, date, etc.)

# Export database to CSV
notion-md-sync database export DATABASE_ID output.csv

# Create new database from CSV
notion-md-sync database create input.csv PARENT_PAGE_ID

# Import CSV to existing database
notion-md-sync database import input.csv DATABASE_ID

🔧 Technical Improvements

Enhanced Converter Architecture

• Pre-processing pipeline for math block extraction
• Improved AST walking for better block detection
• Placeholder system for complex content preservation
• More robust error handling in block conversions

New Types and Interfaces

• EquationBlock type for LaTeX math support
• DatabaseSync interface for CSV operations
• Enhanced property value handling for databases
• Custom NotionDate type for flexible date parsing

Code Quality

• Removed goldmark-mathjax dependency for simpler implementation
• Added strconv import for improved number parsing
• Enhanced test coverage for new features
• Cleaned up unused imports and dependencies

📋 Bug Fixes

• Fixed date parsing issues with multiple format support
• Resolved property type validation errors in database operations
• Corrected select/multi-select property handling
• Improved math block detection and conversion accuracy

📈 Performance

• Maintained fast conversion speeds despite added complexity
• Efficient placeholder replacement system
• Optimized database query pagination
• Concurrent block processing preserved

🚀 Usage Examples

Math Equations

# Quadratic Formula
$$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$

# Maxwell's Equations
$$\begin{aligned}
\nabla \times \vec{E} &= -\frac{\partial \vec{B}}{\partial t} \\
\nabla \times \vec{B} &= \mu_0 \vec{J} + \mu_0 \varepsilon_0 \frac{\partial \vec{E}}{\partial t}
\end{aligned}$$

Database Round-trip

# Export existing database
notion-md-sync database export abc123 products.csv

# Modify CSV locally
echo "New Product,Supplier,SKU-999,50,10,Electronics,2025-07-01,99.99" >> products.csv

# Import back to database
notion-md-sync database import products.csv abc123

💔 Breaking Changes

None! This release maintains full backward compatibility.

🔮 What's Next

Phase 3 will focus on Performance Improvements:

• Concurrent operations for faster syncing
• Caching layer for reduced API calls
• Batch processing optimizations
• Memory usage improvements

Full Changelog: v0.8.2...v0.10.0