obsidian-front-matter-title icon indicating copy to clipboard operation
obsidian-front-matter-title copied to clipboard

Plugin for Obsidian.md

Front Matter Title

Also known as Meta Title Filename

This is a plugin for Obsidian.

Introduction

Plugin does not rename files, it just uses specific value from meta-block of markdown file as displayed filename in explorer or graph.

Value from specific key must be a string or a number or an array(list)

Installation (one of)

  • Download in from Obsidian through Community plugins
  • Use BRAT plugin
  • Download obsidian-front-matter-title-#LAST_RELEASE#.zip from last release and unpack it into your vault by path: .obsidian/plugins

Template

Values

Plugin can use extract values from meta-block, file info or headings.

Also, template can be set as path.to.value and plugin will try to get value from path field, then from to field and, finally from value field. See more.

Meta block

Template is a string that will be used to resolve a title for file

Any value in the template is meant to be key from file's meta block

File info

If you add _ prefix in your template, plugin will use values from TFile object

For example: _basename means that plugin will use value from basename field

Heading

If you set template as #heading, plugin will you first heading from file

Types

Simple template

Any string in you template will be used like a single key

Composite template

If you want to use some values for title you can use {{ }} to make plugin use each value inside {{ }} as an individual key

Examples

For example, you can have the following meta-block:

alias:
  - MPI
status: open
short: 'PI'
tags:
  - '#project'
  - '#improvement'
date_updated: '2022-03-04 22:42:50'
additional:
  author: Snezhig
  title: Project ideas

And the following content:

# First Heading

Some info

# Second Heading
Template Original filename Displayed filename
short 202110151351 PI
additional.title 202110151351 Project Ideas
not_exists 202110151351 202110151351
additional 202110151351 202110151351
tags 202110151351 #project
#heading 202110151351 First Heading
{{short}} - {{status}} 202110151351 PI - open
{{tags}} - {{additional}} 202110151351 # project -

If you use the only one value, use short instead of {{short}} to have a better performance

Managers

Explorer

Display titles in app`s file explorer

Disabled Enabled

Graph

Display titles in app's graph and local-graph

Disabled Enabled

Quick switcher

Display titles in app's quick switcher modal

Disabled Enabled

File header

Display title in opened file's header

Disabled Enabled

Thank you

If you like this plugin and would like to buy me a coffee, you can!

Buy Me A Coffee

Note

Feel free to write about bugs, mistakes or ideas for this plugin.