To write Markdown locally, create or open a .md file in a desktop editor, enter your text, and use a preview to check the formatting. Ulet provides free Markdown editing on Windows and macOS, with visual, source, and split views. Your writing can stay in a folder on your computer while you work.

This guide uses a small meeting-notes file to explain headings, lists, links, and images. You will finish with an editable Markdown file and a simple way to check that its formatting and linked resources still work.

Illustrated comparison of Markdown meeting-note source and rendered headings and lists

An original syntax illustration. It demonstrates the relationship between source text and preview, rather than depicting a software screenshot.

What you need before writing Markdown

Install Ulet and choose a local folder for your notes. Create a Markdown document or open an existing .md file from Home. If a file is stored only in a cloud service, make it available on the computer before going offline.

A Markdown file stores text and formatting symbols. It can refer to images and other files, but those resources usually live separately. This makes the folder structure part of the writing workflow.

Choose the editing view that fits the task

View

Useful for

What to check

Visual editing

Writing with familiar formatting controls

Whether headings, lists, and emphasis have the intended meaning

Source editing

Seeing and changing Markdown symbols directly

Spaces, punctuation, file paths, and code fences

Split view

Comparing the source with its rendered result

Which source change produced the visible formatting

For a first file, source and preview together make it easier to understand the syntax. Visual editing is useful when you want to focus on the wording and use formatting controls as you write. Ulet describes these editing options on its Markdown product page. Explore Ulet Markdown Editor.

Write a small meeting-notes example

Save a file as meeting-notes.md and enter the following example. The names and decisions are sample content that you can replace.

# Meeting notes

Date — 5 November 2026

## Decisions
- Launch date confirmed.
- Draft review moves to Thursday.

## Actions
- Maya updates the schedule.
- Leo checks the presentation.

## Reference
[Project overview](project-overview.md)

In the preview, the first line should appear as the document's main heading. Decisions, Actions, and Reference should appear as section headings. Each line starting with a hyphen and a space should become a list item.

Use headings to describe the structure

Write # followed by a space for the main heading and ## for a section. Use ### for a subsection when a section needs one. Clear heading levels make a longer file easier to scan and help readers understand which ideas belong together.

Use lists for actions and short collections

Start an unordered list item with - . For an ordered sequence, use numbers followed by a period and a space. Keep action items specific enough that another reader knows what happens next.

Write links with meaningful text

A Markdown link combines a label and a destination, such as [Project overview](project-overview.md). The example expects another file named project-overview.md beside the meeting notes. Create that file if you want the sample link to open a real destination.

Core Markdown syntax for headings, lists, links, and images is documented in the original Markdown guide. Preview behavior can vary between editors, especially for extensions beyond the core syntax. Markdown syntax reference.

Add an image without losing its file path

Create an images folder beside your Markdown file and place an image named board.png inside it. Then add this line to your note.

![Planning board with the agreed launch milestones](images/board.png)

The text between square brackets describes the image. The path in parentheses tells the editor where to find it. In this example, the path starts in the folder containing the Markdown document.

Folder layout showing meeting-notes.md beside an images folder containing board.png

Keep the note and its image folder together so a relative path can continue to resolve.

If you move only meeting-notes.md, the relative image path can stop working. Move the containing project folder, including its image folder, then reopen the note from the new location and check the preview.

Check the preview before saving a finished note

  1. Confirm that each heading describes the section beneath it.

  2. Check lists for accidental indentation or missing spaces.

  3. Open the links that a reader will need.

  4. Confirm that every image loads from the intended folder.

  5. Save the file, close its tab, and reopen the saved copy.

If the preview looks unexpected, inspect the nearby source. Common causes include a missing space after a heading marker, an unmatched bracket in a link, or an image filename that differs from the path.

Keep Markdown as the editable source

A Markdown file is useful when you want to keep the writing in a portable text format. Ulet also provides Word and PDF export options for Markdown. When you export, review the resulting pages separately, including long tables, code blocks, images, and page breaks. Keep the source file and its resources available for later edits. Ulet Markdown editing and export options.

Frequently asked questions

Can I write Markdown without an internet connection?

Yes. With a desktop editor installed and the required files stored locally, you can continue writing offline. Remote images and online links still need a connection when you open them.

Does a Markdown file include its images?

Usually the file contains references to images stored elsewhere. Keep relative image folders with the document when moving or sharing it.

Can I edit Markdown without typing every symbol?

Ulet includes visual editing controls as well as source and split views. You can choose the view that fits the part of the task you are working on.

For a local writing workflow, start with a small file, check its preview, and keep its linked resources together. Get Ulet for Windows or macOS.