Writing Content

bim uses Markdown with a few conventions.

Title Extraction

The page title comes from the first # Heading:

# This Becomes the Title

Content here...

If no H1 exists, the filename is used.

Date Extraction

Dates are determined in this order:

1. Filename prefix: 2024-01-15-my-post.md → January 15, 2024
2. Git last modified: Most recent commit touching the file
3. File mtime: Filesystem modification time

Drafts

Mark content as draft in two ways:

1. Underscore prefix: _my-draft.md
2. Drafts directory: blog/_drafts/my-post.md

Drafts are excluded unless you use --drafts:

bim build --drafts
bim serve --drafts

Tags and Contexts

Use inline syntax to tag content:

This post is about [#rust](/tags/rust/) and [#web-development](/tags/web-development/).

It applies to [@linux](/contexts/linux/) systems.

Internal Links

Link to other pages with relative or absolute paths:

See [my other post](/blog/other-post/)
Check the [networking notes](../linux/networking/)

Related: #writing #markdown #content @documentation