Mk Notes

Styling Notion Page

How to guide to customize a Notion page

This document explains how to customize your Notion Page directly from your markdown files


Introduction

Mk Notes relies on frontmatter to be able to add metadata on markdown files.

# Beginning of your markdown file

---

id: unique-page-identifier
title: The notion page title
icon: 💡

---

Compatible properties

Here's the Mk Notes supported properties to customize your Notion Page

id

  • Type: string

optional

This property allows you to specify a unique identifier for your page. This is particularly useful when syncing to a Notion Database with the --clean option enabled.

When clean sync is enabled and the destination is a database, Mk Notes will use this id to find and delete existing pages with the same identifier before creating a new one. This ensures that repeated syncs don't create duplicate entries.

id: <unique-identifier>

Database property

When syncing to a database, the id value is stored in a property named mk-notes-id in your Notion database.

title

  • Type: string

optional

This property allows you to specify a Notion page title. If you do not provide this property, Mk Notes will rely on the name of the file.

title: <string>

icon

  • Type: string

optional

This property allows you to set an icon to your Notion Page.

icon: <emoji-unicode>

Icon limitation

Unfortunately, at the moment, Notion API does not support custom image upload. Only general emojis are available.