A scuba diving experience can leave you with dozens of small memories.
You might remember a colorful reef fish, an interesting rock formation, or the way sunlight changed as you moved underwater.
But a few weeks later, the details can become difficult to recall.
A simple dive log helps organize those memories.
For people interested in scuba diving Maui, especially around Lahaina and nearby Kaanapali, keeping a digital record can be a useful way to document underwater observations.
And if you enjoy working with text files, there is an easy solution: Markdown.
In this tutorial, we will build a lightweight dive log that works in a plain-text editor, a Markdown application, or a Git repository.
No database or complicated software is required.
Why Use Markdown for a Dive Log?
Markdown is a lightweight formatting language.
It lets you create headings, lists, tables, and links using ordinary text.
That makes it useful for organizing information without depending on a complex application.
A Markdown dive log can be:
- Easy to read and update
- Stored locally on your computer
- Organized into folders
- Edited with many different applications
- Backed up or version-controlled
- Expanded as your diving experience grows
It is also flexible.
You can record basic information after a dive or create more detailed notes about marine life and underwater conditions.
One important distinction: this personal template is for reflection and organization. It does not replace an official training log, dive computer data, medical records, or professional dive planning.
Step 1: Create a Dive Log Folder
Start with a folder called maui-dive-log.
Inside it, create one Markdown file for each dive.
For example:
maui-dive-log/
|
|-- README.md
|-- dives/
| |-- 2026-11-19-lahaina.md
| |-- 2026-11-20-west-maui.md
|
|-- marine-life-notes.md
|-- equipment-notes.md
These filenames are examples, not records of actual dives.
The date-first format makes it easier to sort files chronologically.
The README.md file can explain how you organize the collection.
Individual dive files hold personal observations.
Separate notes can contain information you want to reference across multiple dives.
Step 2: Build a Basic Dive Entry
A useful log should be simple enough that you will actually update it.
Start with a small set of fields.
## Dive Record
**Date:** YYYY-MM-DD
**General Area:** Lahaina, Maui
**Specific Site:** To be recorded
**Dive Type:** Shore / Boat
**Certification Level:** To be recorded
**Dive Buddy or Guide:** To be recorded
### Conditions
- Visibility: Not recorded
- Water temperature: Not recorded
- Current: Not recorded
- Surface conditions: Not recorded
### Marine Life Observed
- Add confirmed observations here
### Personal Notes
Write a short description of the experience.
### Follow-Up Questions
- What would I like to learn next?
- Which observations need verification?
This example deliberately avoids invented diving measurements.
Your real entries should come from your actual dive records and observations.
Do not guess depths, water temperatures, or dive times just to fill empty fields.
Step 3: Add a Marine Life Observation Table
A table can make wildlife observations easier to review.
You might want to record the animal, the habitat where you noticed it, and its behavior.
Here is a blank template.
| Marine Life | Habitat | Observation |
|-------------|---------|-------------|
| | | |
| | | |
| | | |
After a real dive, you can fill the rows using your notes.
For example, you may want to describe whether a fish was feeding, resting near shelter, or swimming in a group.
If you cannot confidently identify an animal, record a description rather than guessing the species.
You can update the identification later using reliable reference material.
Step 4: Track Learning Goals With Checkboxes
Markdown supports task lists.
This makes it easy to record learning goals and questions that you want to discuss with a qualified instructor.
## Learning Notes
- [ ] Review unfamiliar marine species
- [ ] Organize underwater photographs
- [ ] Discuss equipment questions with instructor
- [ ] Review responsible wildlife observation
- [ ] Update personal dive records
These checkboxes are for organization, not certification or proof of completed scuba training.
Keep official training and certification records with the appropriate diving organization.
Step 5: Keep Local Context Separate
The underwater environment around Lahaina includes different habitat types.
Rocky areas, reef structures, and sandy seabeds can support different marine organisms.
When documenting observations, it helps to distinguish a general location from a specific dive site.
For example:
location:
island: Maui
region: West Maui
area: Lahaina
dive_site: null
observation:
habitat: null
marine_life: []
notes: ""
verification:
site_access_confirmed: false
observations_reviewed: false
This YAML example demonstrates how information can be stored in a structured format.
The null values indicate that the information has not been entered.
The false values indicate that confirmation has not yet been recorded.
They are not statements about actual site conditions or access.
Structured data can be useful if you later want to organize your dive log in a spreadsheet or write a small script to analyze your notes.
Step 6: Use Consistent File Names
Consistent file names become useful when your collection grows.
A simple pattern is:
YYYY-MM-DD-location.md
For example:
2026-11-19-lahaina.md
Use only the location you actually visited.
Avoid creating detailed site names from memory if you are uncertain.
It can also help to include a short summary at the top of each file so you can find particular observations later.
Step 7: Protect Your Personal Information
A dive log may contain details you would rather keep private.
These can include travel dates, contact information, health-related notes, or other personal records.
If you use Git for version control, remember that a public repository can expose your files to everyone.
Consider keeping your dive journal in a private repository or local folder.
You can also remove sensitive details before sharing an educational example.
For a personal log, privacy should be part of your organization plan from the beginning.
Step 8: Keep Your Notes Accurate
A good digital record is only as useful as the information inside it.
Try to separate three types of information.
Recorded facts: Details taken from an actual dive record, instrument, or confirmed source.
Personal observations: What you remember seeing or experiencing.
Unconfirmed details: Information that still needs checking.
You can use simple labels to make these differences clear.
### Observation Status
- Confirmed:
- Personally observed:
- Needs verification:
This approach is especially useful for marine life identification.
An animal that looks familiar may belong to a different species.
Keeping uncertain observations clearly marked helps prevent mistakes.
A Local Reference for Diving Around Lahaina
Dive Maui / Hawaiian Rafting Adventures is a family-run diving business based at 1223 Front Street in Lahaina, Hawaii.
Its official website includes information about scuba diving, dive training, equipment, and ocean activities.
Some experiences are currently marked unavailable following operational challenges related to the 2023 Lahaina wildfires.
Before planning an activity, confirm the latest schedules, access arrangements, and availability directly with the business.
Readers researching scuba diving information from Dive Maui can explore its official website for background details and contact information.
Build a Record That Becomes More Useful Over Time
A dive log does not need complicated features to be valuable.
Start with a date, a confirmed location, and a few observations.
Add tables when you want to compare information.
Use checkboxes for follow-up tasks.
Keep uncertain details clearly labeled.
Over time, your Markdown files can become a personal reference library of underwater observations, learning goals, and memorable experiences.
The technology is simple.
What makes the record useful is the care you put into it.
And the next time you visit the ocean near Lahaina, you may notice something worth writing down.
Top comments (0)