kerim avatar

logseq-outline

Format any content as a Logseq-compatible outline using nested bullets (no markdown headers, no bold

by kerim|Open Source

Logseq Outline Formatting Skill for Claude

A Claude skill that formats any content as Logseq-compatible outlines using nested bullets (no markdown headers, no bold styling). Works in both Claude Code and Claude Desktop.

What This Does

Teaches Claude to format structured content for Logseq using proper outline hierarchy:

  • ✓ Nested bullet points - Uses tabs/indentation, not markdown headers
  • ✓ Plain text - No bold or italic styling for emphasis
  • ✓ Proper links - Markdown-formatted URLs
  • ✓ Environment-aware - Artifacts for Desktop, files for Code

Use Cases

  • Research notes and summaries
  • Reading lists
  • Meeting notes
  • Project plans
  • Documentation outlines
  • Any hierarchical content for Logseq

Installation

Claude Desktop

  1. Download the latest release or the zip file
  2. Open Claude Desktop
  3. Go to Settings → Skills
  4. Click "Import Skill"
  5. Select the logseq-outline.zip file

Claude Code

# Clone or download this repository
git clone https://github.com/kerim/logseq-outline-skill.git

# Copy to skills directory
cp -r logseq-outline-skill ~/.claude/skills/logseq-outline

How It Works

Example Input

User: "Format these meeting notes for Logseq"

Example Output

- Meeting: 2025-10-25 - Project Planning
	- Attendees
		- Alice
		- Bob
		- Carol
	- Discussion Points
		- Topic 1: Budget
			- Decision: Approved $50k
			- Owner: Alice
		- Topic 2: Timeline
			- Decision: Launch in Q2
			- Owner: Bob
	- Action Items
		- Finalize budget (Alice)
			- Due: 2025-11-01
		- Create timeline (Bob)
			- Due: 2025-11-05

Key Formatting Rules

✓ DO

  • Use nested bullet points with indentation
  • Use plain text throughout
  • Format links as [text](url)
  • Organize by hierarchy/nesting

✗ DON'T

  • Use markdown headers (#, ##)
  • Use bold (**text**) for emphasis
  • Add summary sections at the end
  • Use horizontal rules (---)
  • Include item counts or statistics

Environment-Specific Behavior

Claude Desktop

Creates a markdown artifact with the formatted outline:

  • Easy to copy and paste
  • No file system access needed
  • Directly into Logseq

Claude Code

Saves to a file on Desktop and opens in BBEdit:

  • File path: /Users/niyaro/Desktop/Topic_Name_Outline.md
  • Automatically opened for review
  • Confirms location to user

Examples

Research Notes

- Research Project: Embodied Cognition
	- Background
		- Key concept 1
			- Definition
			- Examples
		- Key concept 2
			- Definition
	- Findings
		- Finding 1
			- Evidence
			- Source
		- Finding 2
			- Evidence
	- Next Steps
		- Action item 1
		- Action item 2

Reading List

- Reading List: Cognitive Science
	- Must Read
		- Metaphors We Live By, Lakoff & Johnson (1980)
			- Why read: Foundation of embodied cognition
			- Length: 256 pages
		- The Embodied Mind, Varela et al. (1991)
			- Why read: Enactivist perspective
	- Recommended
		- Philosophy in the Flesh, Lakoff & Johnson (1999)
			- Why read: Extended application of metaphor theory
	- Optional
		- Where Mathematics Comes From, Lakoff & Núñez (2000)

Project Plan

- Project: Website Redesign
	- Goals
		- Improve user experience
		- Increase conversion by 20%
	- Timeline
		- Phase 1: Research (Weeks 1-2)
			- User interviews
			- Competitor analysis
		- Phase 2: Design (Weeks 3-5)
			- Wireframes
			- Mockups
		- Phase 3: Development (Weeks 6-10)
			- Frontend
			- Backend
	- Budget
		- Design: $10,000
		- Development: $25,000

Conversion Examples

From Markdown Headers

Input:

# Main Topic
## Subtopic 1
Content here
## Subtopic 2
More content

Output:

- Main Topic
	- Subtopic 1
		- Content here
	- Subtopic 2
		- More content

From Bold-Heavy Format

Input:

- **Section 1**
  - **Point 1:** Details
  - **Point 2:** More details

Output:

- Section 1
	- Point 1: Details
	- Point 2: More details

Why This Skill?

Problem: Claude often formats content with markdown headers and bold styling, which doesn't work well in Logseq's outline-based structure.

Solution: This skill teaches Claude to use Logseq's native format - nested bullets with plain text.

Benefits:

  • Content pastes cleanly into Logseq
  • No manual reformatting needed
  • Proper hierarchy from the start
  • Works across both Claude environments

Related Skills

  • zotero-mcp - Search Zotero and generate bibliographies (includes Logseq formatting for bibliographic content)
  • zotero-tagging - Tag Zotero items after searches

Contributing

Contributions welcome! To improve this skill:

  1. Fork this repository
  2. Make your changes to SKILL.md
  3. Test in both Claude Desktop and Claude Code
  4. Submit a pull request

License

MIT License

Support

For issues or questions:

Made for researchers and note-takers who want clean, hierarchical content in Logseq.

Download Skill