From 6255c1ace910278f327de80eafc14389564ce4a0 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 16 Nov 2025 22:11:11 -0600 Subject: feat: Add toggle for org-appear mode (C-c C-a) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Implemented cj/org-appear-toggle to control when emphasis markers and link URLs are revealed. Useful for editing links while keeping tables readable when long URLs would otherwise expand and break layout. Changes: - Enabled org-appear package (removed :disabled flag) - Removed auto-enable hook (default: OFF for cleaner reading) - Added cj/org-appear-toggle function with clear user feedback - Bound to C-c C-a in org-mode-map - C-c C-a was unbound (no conflict with org-attach or other commands) Usage: - Default: OFF (links and emphasis markers stay hidden) - Press C-c C-a: Turn ON (markers show when cursor is on them) - Press C-c C-a again: Turn OFF (back to hidden) Closes todo.org line 29: "Toggle org-appear on/off" 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- modules/org-config.el | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/modules/org-config.el b/modules/org-config.el index 5cae1d0e..f64f6b7e 100644 --- a/modules/org-config.el +++ b/modules/org-config.el @@ -142,7 +142,8 @@ ("C-c >" . cj/org-narrow-forward) ("C-c <" . cj/org-narrow-backwards) ("" . org-reveal) - ("C-c " . widen)) + ("C-c " . widen) + ("C-c C-a" . cj/org-appear-toggle)) (:map cj/org-table-map ("r i" . org-table-insert-row) ("r d" . org-table-kill-row) @@ -224,13 +225,26 @@ ;; -------------------------------- Org-Appear --------------------------------- (use-package org-appear - :hook (org-mode . org-appear-mode) - :disabled t + ;; Default: OFF (toggle with cj/org-appear-toggle) + ;; Useful for editing links, but can make tables hard to read when links expand :custom (org-appear-autoemphasis t) ;; Show * / _ when cursor is on them (org-appear-autolinks t) ;; Also works for links (org-appear-autosubmarkers t)) ;; And sub/superscripts +(defun cj/org-appear-toggle () + "Toggle org-appear-mode in the current org-mode buffer. +When enabled, org-appear shows emphasis markers and link URLs only when +point is on them. When disabled, they stay hidden (cleaner for reading, +especially in tables with long URLs)." + (interactive) + (if (bound-and-true-p org-appear-mode) + (progn + (org-appear-mode -1) + (message "org-appear disabled (links/emphasis stay hidden)")) + (org-appear-mode 1) + (message "org-appear enabled (links/emphasis show when editing)"))) + ;; ------------------------------- Org-Checklist ------------------------------- ;; needed for org-habits to reset checklists once task is complete -- cgit v1.2.3