Feature request: Folding sections of text

tessus · 2020-02-12T22:58:33.287Z

Now @laurent has to accept it…

github.com/laurent22/joplin

add option to show line numbers in editor

laurent22:master ← tessus:feature/line-numbers

opened 10:57PM - 12 Feb 20 UTC

tessus

+2 -1

nemesis5 · 2020-02-13T06:10:17.186Z

This is completely good for me. The “Full integration” was just an idea. I did not know if this is needed by other users and if this is wanted by laurent. It was just an idea.

Thank you for your ideas about that and your commitment to implement the config change.

tessus · 2020-02-13T06:37:24.717Z

You are welcome. Now we have to see, if the PR gets accepted.

sciurius · 2020-02-13T19:45:36.316Z

Unfortunately the details text is not treated as markdown. This makes this feature pretty useless.

nemesis5 · 2020-02-14T06:27:49.417Z

Hi sciurius,

yes, you are right. I’m sorry for not retesting the stuff, I used the code from ipra and just tested the folding…

I found out that for rendering markdown code inside the <summary> and inside the folded text an empty line before the markdown code is needed. The markdown renderer inside this forum here shows the exact same behavior.

The following example shows how to render markdown inside the summary and the content of a folded section. The only issue that it shows, is that the folding arrow is shown in an empty line before the summary headline.

Code

<details markdown='1'><summary>

### Summary of folded text
</summary>

Test List
* first item
* second item

#### Test subchapter 1

Test numbered list
1. Numbered list item 1
2. Numbered list item 2

#### Test subchapter 2
Text

Extended information which is folded by default.
</details>

Rendered result

Summary of folded text

Test List

first item
second item

Test subchapter 1

Test numbered list

Numbered list item 1
Numbered list item 2

Test subchapter 2

Text

Extended information which is folded by default.

nemesis5 · 2020-02-14T07:09:52.841Z

Hi tessus,

my idea behind the whole folding stuff is coming from an experience I made with a wysiwyg text editor. It displays a folding arrow besides each headline. With that you can fold down your document to have a better overview and to blend out not needed details.

Do you think that maybe such a behavior (automatically support folding of headlines inside the rendered markdown) can be implemented inside the markdown renderer? This would not need to extend toolbars etc, so the main user will not see any change but the arrows shown in the rendered markdown besides each headline...

For me this would be very great. A second step for this feature could be that the state of the folding would be safed inside the markdown code of the headline. With this it would be like importing antigravity...
I think about something like extending the markdown code for headlines with an optional part that tells if the content is folded or not. As soon as the user folds down a headline inside the markdown preview (rendered), the [folded] tag appears inside the editor between the headline start tag ### and the headline text.

@laurent What do you think about that? This could make the work with long notes much more comfortable for power users...

Code

### Standard headline - as supported right now
Text

### [folded] Folded headline
Text which is folded at the moment

Expected rendered markdown

(the displayed arrows should be in the same line as the headline, sorry for that)

Standard headline - as supported right now

Text

Summary of folded text

Text which is folded at the moment

tessus · 2020-02-14T09:57:59.912Z

I think there are 2 topics around folding: one is the text (source/markdown)and the other is the rendered text (preview).

The folding marks in the editor will allow you to fold text in the editor. Nothing will happen on the preview side.And the folding marks will be whereever the ace editor thinks they should be. (I know they will fold sections (header to the next header), or code blocks, but I’m not sure what else. I don’t use code folding for taking notes. Especially since those will be uncollapsed again when you open the note. They do not persist. So what’s the point?

Folding in the preview is only possible with the HTML that was discussed earlier.

I think any more than that is out of the scope of this project. This is a note-taking application, not a content management system with word processor capabilities. And I am glad that it isn’t. I despise word processors for many reasons which I don’t want to go into.

I certainly understand your wish to add certain features, but IMO there are more important things to tackle first.

nemesis5 · 2020-02-14T10:23:44.799Z

My last post here was for “Folding on rendered markdown”.
For me it is ok, if there is a decision to not do anything in such a direction. It was just an idea, because I think this could help all power users that have big notes.

Clear statement from your side tessus.
Thank you.

tessus · 2020-02-14T10:38:21.654Z

I’m not saying that this will never make it into Joplin. First Laurent has to accept it and then you will have to find someone to implement it.

teynav · 2020-04-12T02:17:52.896Z

Couldn’t agree more!! It also becomes easy to navigate in large notes

diibv · 2020-09-28T00:25:00.112Z

I am working with large notes and I also think that folding sections will be extremely useful to help navigation within the relevant parts of a note in both editor and rendered HTML (could be an option for both).

Even if they are unfolded on each note reload, it is better than nothing (a simple "collapse all" button would be nice though).

nfarrar · 2020-11-26T18:58:21.452Z

Throwing a vote in on editor folding! My two cents:

I couldn't care less about folding within the rendering.
Folding within the editor is one of the most valuable features for any editor.
Folding lets you easily work within a particular scope of a document without being getting totally and completely lost; especially when working in larger documents.

+1 for editor folding.

CalebJohn · 2020-11-26T19:26:34.204Z

This is possible to add with a plugin, but likely won't make it to the base application. Just keep your eyes open, I'm sure a plugin will popup soon

tessus · 2020-11-26T19:36:43.027Z

Please don't forget that Joplin is not a text editor - or at least it is not its main purpose.
Also, even if there was code folding, it would not be persistent, so how useful is it really? Anyway, Caleb is right. This might be done via plugin at one point.

ambrt · 2021-03-27T17:21:06.706Z

Persistent text folding in editor Plugins

Hi This quick plugin allows to fold markdown text by headers: [Peek 2021-03-28 18-29] Update: v1.2.4 Ctrl(or Cmd) + Alt + F to fold all Ctrl(or Cmd) + Alt + U to unfold all This version fixes bugs and introduces fold/unfold all shortcuts. v1.2.0 has a way to persist folding ! As for now, it adds dot (".") at the end of header to mark it as to be fold on load of note. v1.2.0, should be available soon in Plugins search menu. Manual download:

Had really little time so its as basic as can be.

@tessus makes good point about persistence,
maybe rewriting cm addon itself would allow for
programmatic folding, hence saving folding

SomeParsley · 2021-04-13T00:36:30.603Z

Just my two cents: while Joplin is made to be a coding application first, it should be equally friendly for those that want to put notes in Joplin. One of the reasons I moved to Joplin was because of its encryption. Unfortunately, Joplin doesn't seem to have easy access to features OneNote had - such as using Tab easily, as well as collapsible text. In OneNote, you could collapse any text that was tabbed underneath the text. All you would do would be to double click the left side of the main title and BAM, all text would be collapsed. PLUS, it would stay that way until you un-collapsed it.

CalebJohn · 2021-04-13T00:54:01.537Z

SomeParsley:

while Joplin is made to be a coding

This is a misconception that comes up on this forum every now and then. Where did you hear this? Or at least what made you think that Joplin is even suitable for coding?

SomeParsley · 2021-04-13T13:13:00.565Z

I read tessus' post that "Please don't forget that Joplin is not a text editor - or at least it is not its main purpose." on this thread. I defaulted to assuming that it was for code, as it does use the markdown editor heavily.

tessus · 2021-04-14T06:39:44.045Z

Hmm, for coding one actually use a text editor.

martinkorelic · 2021-04-14T11:43:46.495Z

Well, if you are still interested in folding texts in preview window without typing the html tags, check out this plugin:

Plugin: Spoiler cards Plugins

Hello everyone! Recently I have created a plugin for myself, so now I am sharing it! This is my first attempt at creating a plugin for Joplin. I always felt like I needed to create a card of some sort with an extendable body. You could do that in plain html, but it just felt like there something was missing and it would be just tedious to copy and copy the same plain html all over again. This plugins allows you to create these spoiler cards from a specific format. The cards display as spoile…

For now the format for creating spoilers / folding text is:

:[
Card name here...

Card body text here...

]: