Skip to content
KB4IT Help

blog

Reference Themes Configuration basic
On this page

blog publishes your documents as posts, newest first, with an excerpt on the home page and an archive by date.

The blog home page

Write a post

---
Author: Tomás Vírseda
Category: Post
Date: 2026-09-28
Tag: markdown, notes
---

# Moving my notes to plain Markdown

## Excerpt

Why plain text files outlive every note app I tried.

## Body

The full text...
  • The home page shows the text of the ## Excerpt section and a Read more link. A post without one shows "Excerpt missing".
  • Date orders the posts and places them in the archive.
  • The author and date are shown under the title when the post has them.

Pages

Page Shows
index.html The newest posts with their excerpts
events.html The archive, by year and month
all.html Every document in a table
bookmarks.html Documents with Bookmark: Yes
properties.html Every property and its values
stats.html A tag cloud of the values
feed.xml Atom feed of the newest posts, when site_url is set; see feed
search.html Full-text search over every document, with filters by Category and Tag; the search box in the sidebar shows the best matches as you type. See search
404.html "Page not found", in the theme's layout, with a link home and the search box. A web server shows it for a missing address; see serving it. A document named 404.md is left out with DOC_NAME_RESERVED

Icon, diagrams and formulas

  • The icon of the browser tab is logo from repo.json; without it, the theme's own logo (images/logo.svg).
  • Documents can hold Mermaid diagrams and formulas.

Settings

Key Default Meaning
index_posts 10 Number of posts on the home page
strict false When true, only Category: Post documents use the post layout; other documents use a plain page
datatable Columns of the document tables; the default app uses Date, Title and Topic
git, git_server, git_user, git_repo, git_branch, git_path Edit links; git_server is a full URL such as https://github.com

See also the common settings.

Linked from

Related pages

  • Reference techdoc
    The techdoc theme for team knowledge bases, the properties it reacts to and its settings.
  • Reference bookshelf
    The bookshelf theme for study notes organised as books, parts and chapters, with reading progress.
  • Reference apphelp
    The apphelp theme for application help sites, its page properties, help ids and settings.
  • Reference Log codes
    Every error and warning code KB4IT writes to its log, what it means and what to do.
  • Reference Command line
    Every kb4it command and option, and what the exit status means.