Open a documentation folder in Aero Markdown and let its links carry the context. A relative link to another Markdown file inside that folder opens in the app. Back and forward remember your place as you move between documents. This guide covers Aero Markdown itself; for how relative links behave in any reader, including missing files and headings, see Relative Markdown links.
Start with a small folder
Download and unzip the example folder, then open it with File → Open Folder…. Choose README.md in the file tree.
Its Architecture link is ordinary Markdown:
[Architecture](architecture.md)
Select that link in the rendered page. The architecture document opens in the reader, with its own headings in the outline. Follow its link to the release notes to continue through the folder.
Go back to the page you were reading
Use the Back control to return to the previous document and its reading position. Forward moves along that same history when available.
The file tree is another way to choose a document directly. Next and previous document navigation let you move through the files without following a link in the text.
These are different ways to reach a document; you do not need to create wiki links or a new cloud library.
Link directly to a heading
The architecture file in the example links to the specification acceptance criteria:
[Acceptance criteria](specification.md#acceptance-criteria)
The filename identifies the document; the part after # identifies a heading in it. Aero Markdown can copy a relative link to the current heading so you can refer to that section from another document.
Use the heading outline when you want to navigate within the current page. It follows that document’s structure rather than listing other files.
Know where a link will open
| Link destination | Reading behavior |
|---|---|
| Markdown file inside the opened folder | Opens in Aero Markdown |
| Heading in a document | Navigates to the referenced section |
| Path outside the opened folder | Does not open as an in-folder Markdown page; the app reports the boundary |
| HTTP or HTTPS address | Opens in your browser |
An external website does not become a document inside the reader. The opened folder is the boundary for relative file navigation.
If a link does not reach its document
Check the target filename, its path relative to the source file, and the folder you opened. Renaming or moving a file can leave an older link pointing to the wrong place. A file also needs to be a supported Markdown document to open as a page in the reader.
For a general walkthrough of folder structure, see navigating linked Markdown files. For the rest of the window, see the reading features.