Yamado is a note & journal system with extensions for functioning as a homepage & blog.

Project maintained by orbifx Hosted on GitHub Pages — Theme by mattgraham


Yamado is a note & journal system with extensions for functioning as a website. The file system is used to store all data and the system is mostly text-driven. All articles are submitted as files in the Yamado format, which is YAML + Markdown.



Requiring a markdown processor:

More converters planned to come.

Other resources




Yamado is an interface to a system of scripts and programs. The normal command format is yamado <subcommand>. Try yamado help.

The simplest way to write an article is with:

yamado write -i

Which will ask you some questions and then launch an editor. Once saved and closed, the article is added in the repository.

To run the publishing hooks (e.g. the HTML converter), run:

yamado publish

To further customise and extend Yamado, look into hooks/.

YMD Format

A .ymd file has two segments, the YAML header and the Markdown body. Calling yamado form prints an empty template header and space for the markdown.

Take a look at the empty template of a ymd header, the fields are quite self-explanatory.

For more information look at the yamado man page.


The files in this directory constitute the Yamado system.

Yamado client

Install the yamadoclient script on your local system and configure $HOME/.config/yamado/client.conf. Checkout the example client.conf in share/.

The available commands are:


AGPL 3.0: http://www.gnu.org/licenses/agpl-3.0.txt

All files are distributed provided by Yamado are licenced under AGPL 3.0. A brief of the licence is at the bottom of this file and a full copy in LICENCE. Some files are without notice, list at the end of this file.

AGPL brief

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Files without notice

The following files don't contain a licence notice but are still under AGPL 3.