> For the complete documentation index, see [llms.txt](https://unofficial-logseq-docs.gitbook.io/unofficial-logseq-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unofficial-logseq-docs.gitbook.io/unofficial-logseq-docs/general/getting-started.md).

# Getting Started

In Logseq, a collection of notes is called a **graph**. Think of a graph as a directory location in Windows Explorer / Finder, a safety deposit vault, it simply is a name given for a collection of items.

### To get started:

1. Download [Logseq](https://logseq.com/) on your desktop. 
2. Fire it up and you will get a message about selecting a local directory. 
3. Follow the on-screen instructions. You can select the location where you want to store your Logseq Graph. Some users have it on their local machine (in My Documents, for example), while others store them on a cloud-sharing service like Google Drive, OneDrive, or DropBox, which has the advantage of giving you access to your notes on different computers.  Let your heart guide you to its desired location.
4. You are good to go and can start typing out your thoughts, feelings and notes, or anything else that takes your fancy.

#### Importing Markdown Files

With the new Logseq Graph set-up, should you wish to import previous markdown (.md) files, you can do so simply by opening Windows Explorer / Finder, navigating to the Logseq Graph Directory and copying and pasting your files to the `pages` directory. Open Logseq, refresh (top left-hand corner) and voila.

This very brief guide has hopefully given you sufficient assistance in getting started. There is not much to getting started with Logseq in reality. Open up, write notes and start to scratch the surface to uncover amazing features. 


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://unofficial-logseq-docs.gitbook.io/unofficial-logseq-docs/general/getting-started.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.