Configuration file

Eleventy Notes provides several configuration options to customize the app. All of them are optional, but a basic configuration is recommended.

Basic configuration #

Create a new file app.json in the root of the project, next to your notes. Add a custom title (shown in the header) and a description (not shown but used by search engines):

{
  "title": "John's Notes",
  "description": "The personal notes of John Doe"
}

JSON Schema #

If you use an editor like VS Code that supports JSON schema, add the $schema property to your configuration file. This will give you autocompletion, descriptions and validation:

{
  "$schema": ".app/app.schema.json"
  // ...
}

Supported configurations #

In addition to the basic configuration, you can also:

• Add an edit link to your notes, see Edit link
• Customize the notes in the sidebar or add links to other websites, see Sidebar
• Change the color scheme, see Themes
• Customize the behavior of Wikilinks, see Wikilinks

Summary #

The following example shows the supported configuration options:

{
  "title": "John's Notes",
  "description": "The personal notes of John Doe",
  "theme": {
    "color": "sky"
  },
  "editThisNote": {
    "url": "https://example.com/edit/{{file}}"
  },
  "sidebar": {
    "links": [],
    "notes": [{}]
  },
  "wikilinks": {
    "autoLabel": "ref",
    "anchorLabel": "none"
  }
}