Eleventy Notes

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.js in the root of the project, next to your notes. Add a custom title (shown in the header), a description (not shown but used by search engines) and define the language of your content:

const {defineConfig} = require('.app/app-config')

module.exports = defineConfig({
  title: "John's Notes",
  description: 'The personal notes of John Doe',
  lang: 'en'
})

TypeScript

If you use an editor like VS Code, you can add type-checking to your configuration file by adding the following comment at the top of the file:

// @ts-check

This will warn you about invalid configuration options.

Supported configurations

In addition to the basic configuration, you can also:

  • Adjust the URL of your notes, see Files and Folders
  • Add an edit link to your notes, see Edit link
  • Customize the notes in the sidebar or add links to other websites, see Sidebar
  • Customize the content of the panel, see Panel
  • Configure custom properties in the panel, see Custom Properties
  • Change the color scheme, see Themes
  • Customize the behavior of Wikilinks, see Wikilinks
  • Create mappings for your tags, see Tags

Summary

The following example shows the supported configuration options:

modul.exports = defineConfig({
  title: "John's Notes",
  description: 'The personal notes of John Doe',
  lang: 'en',
  customProperties: {
    properties: []
  },
  theme: {
    color: 'sky'
  },
  editThisNote: {
    url: 'https://example.com/edit/{{file}}'
  },
  sidebar: {
    links: [],
    sections: []
  },
  panel: {
    tableOfContents: true,
    tags: true,
    customProperties: true,
    incomingLinks: true,
    outgoingLinks: true,
    externalLinks: true
  },
  wikilinks: {
    autoLabel: 'ref',
    anchorLabel: 'none'
  },
  tags: {
    map: {}
  }
})