Editor Settings
Customize the SQL editor to match your coding preferences. Access editor settings via Settings > Editor.
Font Settings
Font Family
Choose from available monospace fonts:
| Font | Description |
|---|
| System Mono | macOS default monospace (recommended) |
| SF Mono | San Francisco Mono |
| Menlo | Classic macOS monospace |
| Monaco | Traditional Mac programming font |
| Courier New | Cross-platform standard |
System Mono is recommended as it automatically uses the best available system monospace font.
Font Availability
Not all fonts are available on every system:
| Font | Availability |
|---|
| System Mono | Always available |
| SF Mono | macOS 10.12+ |
| Menlo | macOS 10.6+ |
| Monaco | macOS Classic |
| Courier New | Standard system font |
If a selected font isn’t available, TablePro falls back to System Mono.
Font Size
Adjust the editor font size:
| Setting | Range | Default |
|---|
| Font Size | 11-18 pt | 13 pt |
Recommendations:
| Size | Best For |
|---|
| 11-12 pt | Small screens, seeing more code |
| 13-14 pt | Standard usage (default) |
| 15-16 pt | Better readability |
| 17-18 pt | Large screens, accessibility |
Display Settings
Line Numbers
| Option | Description |
|---|
| On | Show line numbers (default) |
| Off | Hide line numbers for minimal interface |
Line numbers help with:
- Referencing specific lines
- Error messages that mention line numbers
- Navigating large queries
- Discussing code with others
Current Line Highlight
| Option | Description |
|---|
| On | Subtly highlight the line with cursor (default) |
| Off | No highlight on current line |
This helps track your cursor position, especially in long queries.
Word Wrap
| Option | Description |
|---|
| Off | Long lines scroll horizontally (default) |
| On | Long lines wrap to next line |
When to enable word wrap:
- Working on narrow screens
- Queries have long lines
- Prefer not to scroll horizontally
When to disable word wrap:
- Prefer consistent line lengths
- Working with formatted queries
- Need to see query structure clearly
Indentation Settings
Tab Width
Set how many spaces a tab represents:
| Setting | Options | Default |
|---|
| Tab Width | 1-16 spaces | 4 |
Common choices:
| Width | Usage |
|---|
| 2 spaces | Compact code, JavaScript style |
| 4 spaces | Standard SQL formatting (recommended) |
| 8 spaces | Traditional, Unix-style |
Auto Indent
| Option | Description |
|---|
| On | New lines match previous indentation (default) |
| Off | New lines start at column 1 |
Auto indent helps maintain consistent formatting:
SELECT
u.id,
u.name,
| -- Cursor here, next line auto-indents
Editor Behavior
Text Entry
The editor behaves like a standard macOS text editor:
- Standard keyboard shortcuts work
- Copy/paste functions normally
- Undo/redo history is maintained
- Selection works with mouse and keyboard
Autocomplete
Autocomplete cannot be disabled but can be dismissed with Escape.
See Autocomplete for details on using this feature.
Applying Settings
Settings apply immediately:
- Change a setting
- The editor updates in real-time
- No restart required
Recommended Configurations
Default (Balanced)
Font Family: System Mono
Font Size: 13 pt
Line Numbers: On
Current Line: On
Tab Width: 4
Auto Indent: On
Word Wrap: Off
Compact (More Code Visible)
Font Family: SF Mono
Font Size: 11 pt
Line Numbers: On
Current Line: On
Tab Width: 2
Auto Indent: On
Word Wrap: Off
Comfortable (Easy Reading)
Font Family: Menlo
Font Size: 15 pt
Line Numbers: On
Current Line: On
Tab Width: 4
Auto Indent: On
Word Wrap: On
Minimal (Clean Interface)
Font Family: Monaco
Font Size: 13 pt
Line Numbers: Off
Current Line: Off
Tab Width: 4
Auto Indent: On
Word Wrap: Off
Accessibility
Font Family: System Mono
Font Size: 18 pt
Line Numbers: On
Current Line: On
Tab Width: 4
Auto Indent: On
Word Wrap: On
Syntax Highlighting
The editor automatically highlights SQL syntax:
| Element | Color (Dark) | Color (Light) |
|---|
| Keywords | Pink | Pink |
| Strings | Green | Green |
| Numbers | Blue | Blue |
| Comments | Gray | Gray |
| Functions | Default | Default |
| Identifiers | White | Black |
Syntax colors automatically adapt to the current theme.
Highlighted Keywords
SQL keywords that are highlighted include:
SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, DROP
FROM, WHERE, JOIN, ON, GROUP BY, ORDER BY, HAVING
AND, OR, NOT, IN, LIKE, BETWEEN, IS NULL
INNER, LEFT, RIGHT, OUTER, CROSS, UNION
- And many more SQL standard keywords
Keyboard Shortcuts in Editor
| Action | Shortcut |
|---|
| Execute query | Cmd+Enter |
| Undo | Cmd+Z |
| Redo | Cmd+Shift+Z |
| Find | Cmd+F |
| Replace | Cmd+Option+F |
| Select All | Cmd+A |
| Go to Line | Cmd+G |
See Keyboard Shortcuts for the complete list.
Troubleshooting
Font Not Appearing Correctly
- Verify the font is installed on your system
- Try selecting a different font
- Restart TablePro
Settings Not Saving
- Check disk permissions
- Verify preferences file is writable:
ls -la ~/Library/Preferences/com.TablePro.plist
- Try resetting preferences
Editor Feels Slow
- Reduce font size (larger fonts render slower)
- Disable word wrap for long queries
- Check for very large queries in editor
Related Pages