Logseq Plugin: Left Sidebar Enhance

Note

This plugin works on Logseq db version.

English|日本語 Released: 20231002

Main Features

This plugin provides five main features:

1. Page Outline (=Table of contents :Auto-generated)
2. Hierarchical Heading Numbering (File-Based Model Only)
3. Auto-adjust Markdown Heading Levels (File-Based Model Only) 🆕
4. Auto-hide/show Left Sidebar
5. Visual Timer

---

1. Page Outline Feature

   • Automatically displays a Page Outline in the left menu, generated from headers in the opened page's content

   (Markdown headers: #,##,###,####,#####,######)

   Quick Actions:

   • Click: Jump to header position
   • Ctrl+Click: Open as zoom page
   • Shift+Click: Open in right sidebar
   • Shortcut keys (MD version only): Alt+1 to Alt+6 to insert headers

   

2. Hierarchical Heading Numbering (File-Based Model Only)

   • Automatically adds hierarchical numbers (1, 1.1, 1.1.1, etc.) to markdown headings
   • File-Update Mode: Directly modifies markdown files to add numbers
   • Per-Page Activation: Toggle numbering for individual pages using toolbar icon
   • Customizable Delimiters: Configure number separators (e.g., ".", "-", "→")
   • Cleanup Function: Remove all heading numbers from current page
   

3. Auto-adjust Markdown Heading Levels 🆕 (File-Based Model Only)

   • Automatically normalizes Markdown heading levels based on outline depth
   • Three Presets: Choose from H2-H6 (default), H1-H3, or H2-H4 ranges
   • H1 Reservation: Option to reserve H1 for page titles
   • Commands: Normalize entire page or selected blocks
   • Detailed Documentation: Auto-adjust Markdown Heading Levels Guide

4. Auto-hide Left Menu on Mouse Over (Default: Disabled)

   Use the button in the top-left corner.

5. Visual Timer Feature

   

---

Installation

Install from Logseq Marketplace

• Click [---] on the toolbar to open [Plugins]. Select Marketplace. Type Left in the search field and select it from the results to install.

Usage

• Page Outline: When opening any page, the TOC automatically appears in the left sidebar menu.
  • How it works:

    Automatically detects both Markdown (#) and Logseq DB format headers

    • Updates automatically when content changes
    • Click to scroll to header position
  • Note:
    • By default, when opening the journal, it shows a list of dates loaded by scrolling. To view the TOC, open a date page.

    Turn off this option in plugin settings to show header list for the current day's page.

• Mouse Over: Click the button in the top-left corner. The left sidebar state will toggle. Shortcut keys work the same way.
• Use plugin settings to enable/disable each feature.

User Settings

1. Hide Duplicates in Favorites and History

   • Automatically hides duplicates between favorites and recent items

   Checks for duplicates on plugin startup and every 10 minutes

2. Left Sidebar Mouse Over Feature

   • Enable/disable auto-show left sidebar on mouse over
   • Select display type: Type A (Corner Hover) or Type B (Edge Hover)
   • Mouse Over Types
     1. Type A: Opens when mouse approaches the left corner area

        ⚠️May cause issues with small windows

     2. Type B (Recommended): Opens when mouse is placed on the leftmost column

3. Page Outline (Table of contents) Feature

   • Enable/disable Page Outline feature
   • Open as zoom page by default

     If disabled, Ctrl+Click for zoom page view

   • Mouse over highlight feature
     • Highlight corresponding block when hovering over header
     • Highlight corresponding header when hovering over block
   • Show date list in journal pages
   • List of words to exclude from the header list (line-separated)

4. Hierarchical Heading Numbering Feature (File-Based Model Only)

   • Enable/disable file-update mode for automatic heading numbering
   • Configure number delimiter (new and old for detection/replacement)
   • Per-page activation storage mode
     • Store True Only: Save only enabled pages (default)
     • Store False Only: Enable all pages by default, save only disabled
   • Cleanup function: Remove heading numbers from current page

   Note: Only works with the local file-based model for safety

5. Auto-adjust Markdown Heading Levels Feature 🆕 (File-Based Model Only)

   • Enable/disable automatic heading level normalization
   • Choose heading level range preset (H2-H6, H1-H3, or H2-H4)
   • Reserve H1 for page titles option
   • Commands available via command palette
     • Normalize headings on current page
     • Normalize headings in selection
   • See detailed documentation for more information

---

Showcase / Questions / Ideas / Help

Head to the Discussion tab to ask and find this kind of things.

Related plugins

• Logging Search plugin

  Query-based search plugin that displays fully rendered results. Add a search box in left menu.

  

• Show Weekday and Week-number plugin

  Monthly Calendar

  

Prior Art & Credit

• CSS code (Show left sidebar on mouse over) >
  1. Type A: @mæn
  2. Type B (Default): @sethyuan
• Logseq Plugin >
  1. @hkgnp/ logseq-toc-plugin (TOC display)
  2. @freder/ logseq-plugin-jump-to-block (TOC display)
• Author: @YU000jp