Thursday January 13, 2022; 12:05 AM EST
- Dave asked about Logseq outline howto document similar to Drummer outline editor howto. Logseq outline related info is scattered in 3 help usage official documents accessible from the "?" icon at the bottom right of Logseq main screen or from top right "sidebar icon" and "Help" menu. #
- 1. Keyboard shortcuts - After Triggers and Markdown syntax sections, it covers the Basics section that includes indent and outdent. Further down in Navigation, Block editing and Block command section it covers move block up and down.#
- 2. Documentation - This is published as a Logseq graph/repository that's read-only for most users. It's getting started page doesn't emphasize the outline editing fetures, instead covers page creation, page/blocks reference/embed. There isn't much about outlining in the documentation, though it does have a section on nitty gritty of Logseq Core outliner feature (dev level details).#
- 3. FAQ - It's part of the Logseq documentation graph. It doesn't have any outliner specific questions.#
- I've tried to explain Logseq outline features below based on Drummer outline editor howto structure.#
- What is an outliner?#
- This is almost fully applicable for Logseq outliner too.#
- The bar cursor and text cursor#
- Text cursor, vertical line or caret, is the same in Logseq. #
- Bar cursor in Logseq can also highlight more than one block (headline). Unlike Drummer where it highlight only a specific headline. In Logseq easiest way to select a bar cursor using a mouse would be to click a block (get text cursor), drag mouse up and back down to same block. Click a block and press "Esc" key is also a quick method. Drummer method of clicking on block (headline) bullet will focus/hoist on the block (headline).#
- Wedge in Logseq only appears when you hover to the
right left of the bullet for a block. Clicking it once (not double click) expand (or collapse).#
- What is an outline?#
- Blocks in Logseq is same as Drummer headlines.#
- Top level block doesn't have special name (summit in Drummer)#
- However, Markdown heading (those "#", "##" etc) also acts as a top level block in Logseq but with headings format. Logseq also has block attribute "heading:: true" that acts similar to Markdown heading.#
- Attributes in Logseq is applicable to blocks as well as pages, of the format "attribute:: value1, value2".#
- Page attributes can also be in YAML front matter format. You create page attribute by creating/editing attributes in the first block of a page in Logseq.#
- What does Cmd mean?#
- Cmd-X (Mac) is Control-X (Windows/Linux) in Logseq same as Drummer.#
- How do you enter text into an outliner?#
- When you create a new Logseq page, you'll be automatically in edit mode to enter the first block in the outline. The drummer instructions, works as is:#
- To create a new headline, put the cursor on the headline above where you want the headline to appear and press Return.#
- Type as you would into a text editor. When you want to create another headline, press Return.#
- Indenting/outdenting. If you want to move the headline in by one level press Tab. To move it out by one level, press Shift-Tab.#
- You can bolden the selected text with Cmd-B, and italicize with Cmd-I. To un-bolden or un-italicize, just repeat the Cmd key.#
- Can you explain how the arrow keys work?#
- When in navigation mode (drummer structure mode) ...#
- ↑ moves to the previous headline at the
same regardless level.#
- ↓ moves to the next headline at the
same regardless level.#
- → goes into block edit mode at the end of the block#
- ← goes into block edit mode at the start of the block#
- When in block edit mode #
- ← and → move to the previous and next character.#
- ↑ and ↓ move to the next and previous headline, regardless of level.#
- Logseq customize shortcuts allows changing almost all keyboard commands to what you are familiar with.#
- How do you delete a headline?#
- Drummer bar cursor way works in Logseq. Also can right mouse click on the block bullet and choose "Cut".#
- How does Undo work?#
- How do I reorganize an outline?#
- Moving a block by mouse. Drag block by its bullet, a long underline cursor shows where it will go when you release it. Similar to Drummer drag the wedge except Logseq allow to drag to the very top (first block). Drummer doesn't.#
- Shift-click and Cmd-A#
- Shift-click is the same as click in Logseq. You can however select multiple block using mouse click drag function.#
- Ctrl-A only works within a block.#
- Return vs Enter#
- Return and Enter are the same in Logseq.#
- Promote and demote#
- No specific commands in Logseq. Use indent and outdent.#
- Cut, Copy, Paste#
- Same as normal clipboard.#
- There is additional "Copy as" function on right-click that allow options/formats (Text Markdown, OPML & HTML).#
- Wedges and attributes#
- Logseq attributes does not change the block bullet style. Unlike drummer "type=outline", "type=markdown" etc.#
- Render mode#
- Logseq always in render mode. When editing a block, only that block will go into non-render mode.#
- One-line JavaScript code#
- Logseq doesn't execute Javascript in blocks.#
- However, Logseq execute Simple Query and Advance Query in blocks. They can be multiline. They are written in Datalog/Datomic that query Logseq Datascript database. It's "Daytona++" for a single graph/repo.#
- Commenting#
- No standard "comment" attribute feature in Logseq. However a block can contain a "comment section" that's not displayed but still stored in the block. Can also use a custom block "comment:: true" attribute. #
-Drummer-
-Logseq-
#