Use H1 or front-matter title instead of or in addition to filename as display name

@Fovea Good idea, I added that my original post.


certainly useful - preferably as toggle switch


Another thing you may possible have is if you don’t have H1, you set default to the first line of text in the file

But this should be kind of heuristic if there is no good candidate the filename should stay

There was at least two topics for aliases for notes, I think this could be more general discussion how notes could be referenced

1 Like

+1 to this. I would really like to be able to use a title of some sort (slight preference for front-matter) wherever filename is currently displayed throughout the Obsidian UI.


This FR looks very important to me, especially when there is an enormous list of illegal characters currently in Obsidian, which can not be used in notes file names.


I wrote about a use case that I miss from Notion here, which could be solved by this feature request:

tl;dr I could add emojis to h1 tags that would allow me to quickly assess what I will get a result before I actually open a note.

I’d like to see the note title in the file list. The reason why is that this is not informative:


What are those files about? I don’t know. I’ll have to open each to find out. :disappointed:

Zettlr does it much better:


Here I can see the title that each note has as well as their identifier.

This makes it super easy to quickly look up the identifier for a file I want to link, without having to search or open several files.

Thanks for listening. :slight_smile:


@sam.baron: slightly off topic, but still about front-matter (I think) in the sense of Yaml:

At the bottom of each zettel I have a cordoned-off (with a line) section containing metadata, such as:
Book title, page no.
Zettel creation date
Zettel transcluded in

This info is normal text, therefore searchable.

Is there a compelling reason to put this info in a Yaml box at the top of the zettel?

If this question does not belong here, I’ll open a new topic.

@Klaas Good question, but yes, this is a different topic. We don’t know yet how Obsidian is going to handle metadata.

OK, sorry to have polluted your thread.

Zettlr makes a distinction between filename and note title because of the way it tracks UIDs.
Obsidian does it differently, as do other programs.
Zettlr may be rethinking what they do.

Yes please!!!
Let me use a question mark? in my note title!!!


Another vote for this please! :slight_smile:

1 Like

I’d also find this really helpful :+1:

I’ve been trying to make my mind up about the common question of IDs vs titles as filenames. I currently use the naming convention and am considering removing the text portion of this to avoid having to change the filename each time I want to change the title of the note. If link auto-complete worked by typing a title as an alternative to filename, this would allow me to connect concepts much more easily.

Having said that, because Obsidian makes it really easy to change links when renaming files, I’ve been trying out using descriptive filenames, which has made the writing experience much smoother because I can just link any [[concept]] as I go, and auto-complete makes this pretty seamless. (This post seems to describe a similar experience.) The problem I keep coming across is that I prefer not to have spaces in filenames (which makes scripting easier) but if I use [[hyphenated-links]], the unlinked mentions feature won’t work :see_no_evil: I think this is probably a separate issue (any thoughts welcome), but being able to search by H1 or title for link autocomplete would get me close to this kind of workflow.

I currently use my notes across mac, windows, iOS and Android :roll_eyes: so would rather avoid using Obsidian-specific or less widely accepted formatting like the [[this-is-a-link|pipe]] for link display. I’ve considered moving to [standard markdown links]( but they don’t really serve the same function when it comes to this kind of workflow and they tend to break my train of thought and having to switch to the preview pane to click them is annoying.

(First post, so do let me know if this is a helpful contribution or better taken elsewhere.)


If Obsidian caters Zettelkasten, then I see no reason why this has not been implemented yet.


To use Zettelkasten I need this option too.


Excellent request! I would like Quick Switcher to search for the first heading of a file. It would help me quickly recall and select a UID-only filename without leaving the keyboard and the current note or thought I’m processing.

  • Maybe Settings has a toggle on/off feature for the heading search?
  • In regards to performance issues, maybe limit the search to the first heading? After selecting the file, the remaining headings can be displayed for the selected file instead of scanning every heading in the vault during the initial command?

I want to use a clean UID filename without relying on folders, but I need to find the first heading in my notes, which is the title. For now, I’m putting these UID-only files in folders with their title, so I can find them.


I would love this. If this were implemented and we could still sort the file explorer by actual note title while displaying the frontmatter title, it would solve the problem I’ve detailed here: Retaining the benefits of Luhmann's numbering system without damaging key Obsidian functionality?


Excellent suggestion

Yes we need this! Is there any way we can contribute and help create these features?