Tutorial

README.md

A complete overhaul of Minecraft's book system into a documentation platform.

Product page Downloads Documentation Roadmap

Install README.md #

Install Fabric Loader for 1.21 (plus Fabric API if the downloads page asks for it), place the JAR in your mods folder, and launch with the Fabric profile.

  1. Install the mod for your Minecraft version.
  2. Write Markdown into a book using the editor.
  3. Preview the rendered output live.
  4. Organise works into a library and search them.
  5. Export to Markdown, text, JSON, or HTML, or sync with other players.

Working with README.md #

Product-specific steps, separate from the general install guide above.

Book commands

Manage your in-game books from chat:

/readme new
/readme open <name>
/readme save
/readme search <term>
/readme sync

Themes & config

Both client and server read human-readable JSON configs in config/ — themes included.

Folder locations by platform #

Platformmods / resourcepacks folderconfig folder
Windows%appdata%\.minecraft\mods · \resourcepacks%appdata%\.minecraft\config
macOS~/Library/Application Support/minecraft/mods~/Library/Application Support/minecraft/config
Linux~/.minecraft/mods · ~/.minecraft/resourcepacks~/.minecraft/config

MultiMC / Prism users: these folders live inside Instances/<instance>/.minecraft/. Match the build to your exact Minecraft version — the compatibility table in the docs lists every supported version.

Configure #

Settings live in the config folder (JSON5 files you can edit by hand) and, where available, in the in-game settings screen the mod adds. The exact keys and keybinds are listed in the documentation and the FAQ below.

Tips for README.md #

  • Keep README.md on the version range shown on its product page.
  • If it doesn't load, confirm the JAR is in the right mods folder for the launcher and version you chose.
  • Bedrock Edition, mobile, and console can't run Java Edition mods or packs — for a port or custom variant, request a commission.

README.md FAQ #

Can I read normal books?
Yes — existing books remain readable and upgradeable.
Is it client or server side?
Both — multiplayer sync with MD5 change detection, roles and conflict resolution.
What Markdown does it support?
Rich formatting, colors, ==highlight==, ||spoiler||, callouts, tables, task lists and syntax-highlighted code blocks.
Can I theme my books?
Yes — 8 built-in themes plus custom JSON themes.
What can I import/export?
Markdown, text, JSON and HTML, plus ZIP backups and batch conversion.
Can other mods extend it?
Yes — it ships a public API, EventBus and provider system, plus 15 templates.
Still stuck? Open a guided request — every message is tagged and answered from support@herostudios.dev. Always include your Minecraft version and product version.