esc to dismiss
ObsidianHtml/Tabs-Mode
Filtering notes
Important

This is the documentation for v3.5.0 and lower, for documentation for v4.0.0 and higher, see https://obsidian-html.github.io/

This instruction is valid from version v3.4.0 onwards.

Introduction

If you don't want to export your entire vault, then there are options to set inclusion and or exclusion.
This is controlled by these settings:

  • included_folders
  • exclude_glob

By default, included_folders is set to an empty list, and consequently ignored.
When setting values only the files in the configured folders will be added to the file tree, and thus nothing outside of those folders is exported.

If you want to export all folders, except for one or multiple folders, then you should set exclude_glob.

You can also combine both settings. This will start with finding all the files in only the included folders, and then not adding any files that are excluded.

included_folders

  • All paths are relative to the root of the vault
  • No slash in the beginning is neccessary
  • No glob patterns supported
  • Should be a list, so:
included_folders: my_folder # wrong!
included_folders:
  - my_folder               # correct

exclude_glob

  • Each line is handled as a glob pattern
  • Starting a line with a slash will make the line match a specific folder
  • Not starting a line with a slash will exclude every folder whose name matches the line
  • Should be a list, so:
exclude_glob: stuff # wrong!
exclude_glob:
  - /private_notes
  - stuff                 # correct

Examples

Given the following folder structure:

/path/to/vault/
  a/
    stuff/
      equations.pdf
      picture.jpg
    a_note.md
  b/
    stuff/
      book.pdf
    b_note.md
  c/
    c_note.md
  home.md

We will go through some usecases and provide the correct configurations.

Include only folder /a

# we need to set the entrypoint to a note in the /a folder
obsidian_entrypoint_path_str: '/path/to/vault/a/a_note.md'

included_folders:
  - a

Leads to

/path/to/output/md/
  a/
    stuff/
      equations.pdf
      picture.jpg
  index.md

Note that /a/a_note.md has been renamed to /index.md!

Include everything except for /b (i.e. exclude /b)

# we need to set the entrypoint to a note in the /a folder
obsidian_entrypoint_path_str: '/path/to/vault/home.md'

exclude_glob:
  - /b

Leads to

/path/to/output/md/
  a/
    stuff/
      equations.pdf
      picture.jpg
    a_note.md
  c/
    c_note.md
  index.md

Exclude all stuff folders

# we need to set the entrypoint to a note in the /a folder
obsidian_entrypoint_path_str: '/path/to/vault/home.md'

exclude_glob:
  - stuff

Leads to

/path/to/output/md/
  a/
    a_note.md
  b/
    b_note.md
  c/
    c_note.md
  index.md

Exclude all *.pdf files

# we need to set the entrypoint to a note in the /a folder
obsidian_entrypoint_path_str: '/path/to/vault/home.md'

exclude_glob:
  - *.pdf

Leads to

/path/to/output/md/
  a/
    stuff/
      picture.jpg
    a_note.md
  b/
    stuff/<empty, so not created>
    b_note.md
  c/
    c_note.md
  index.md