Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dundalek/longdown
Convert longform markdown files to outline format used by Logseq
https://github.com/dundalek/longdown
logseq longform markdown outliner
Last synced: 19 days ago
JSON representation
Convert longform markdown files to outline format used by Logseq
- Host: GitHub
- URL: https://github.com/dundalek/longdown
- Owner: dundalek
- License: 0bsd
- Created: 2023-04-18T13:58:21.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-04-13T20:23:36.000Z (7 months ago)
- Last Synced: 2024-04-14T10:53:23.292Z (7 months ago)
- Topics: logseq, longform, markdown, outliner
- Language: Clojure
- Homepage:
- Size: 18.6 KB
- Stars: 21
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-logseq - longdown - CLI tool for converting longform markdown to logseq markdown (🔍 Other Resources / Bibliography and PDF Integrations)
README
# Longdown
Convert longform markdown files to outline format used by Logseq.
## Motivation
I've been using text editor to write my notes as markdown files and rely on the headings structure to organize long notes.
However, when I tried to move my markdown files to Logseq, I faced a problem: the structure wasn't preserved which resulted in a loss of meaning.
This tool helps with transition by converting existing longform markdown files to outline format that preserves the structure in a way that fits well for Logseq.
## Example
For example:
```
# h1
paragraph
## h2
next paragraph
another paragraph
```
Gets converted into:
```
- # h1
- paragraph
- ## h2
- next paragraph
- another paragraph
```
## Usage
Install with:
```
npm install -g longdown
```
#### Converting files
It is a good idea to make a backup of the input files first before running the script!
Specify output directory with `-d` flag and pass input files:
```
cd my-notes
longdown -d ../out *.md
```
Double-check the output, for example compare using the [Meld](https://meldmerge.org/) tool:
```
cd ..
meld my-notes out
```
#### Converting text snippets
Use `longdown -` to read from standard input and print result to standard output.
It can be useful to converting text snippets from clipboard and pasting them directly to Logseq without needing to create intermediate files.
For example on Linux:
```
xclip -selection clipboard -out | longdown - | xclip -selection clipboard -in
```
On macOS:
```
pbpaste | longdown - | pbcopy
```
## License
0BSD
## Development
Install [Babashka](https://babashka.org/) to run development tasks.
List available tasks:
```
bb tasks
```
Run the CLI locally:
```
bin/cli.js
```