delete starter posts
Before Width: | Height: | Size: 95 KiB |
Before Width: | Height: | Size: 15 KiB |
Before Width: | Height: | Size: 9.6 KiB |
Before Width: | Height: | Size: 15 KiB |
Before Width: | Height: | Size: 6.8 KiB |
Before Width: | Height: | Size: 91 KiB |
Before Width: | Height: | Size: 9.2 KiB |
Before Width: | Height: | Size: 29 KiB |
Before Width: | Height: | Size: 19 KiB |
Before Width: | Height: | Size: 13 KiB |
Before Width: | Height: | Size: 10 KiB |
Before Width: | Height: | Size: 6.9 KiB |
Before Width: | Height: | Size: 24 KiB |
Before Width: | Height: | Size: 14 KiB |
Before Width: | Height: | Size: 7.3 KiB |
Before Width: | Height: | Size: 9.3 KiB |
Before Width: | Height: | Size: 22 KiB |
Before Width: | Height: | Size: 5.1 KiB |
Before Width: | Height: | Size: 5.8 KiB |
Before Width: | Height: | Size: 1.4 KiB |
Before Width: | Height: | Size: 17 KiB |
Before Width: | Height: | Size: 8.3 KiB |
Before Width: | Height: | Size: 54 KiB |
@ -1,39 +0,0 @@
|
|||||||
## Obsidian slides demo
|
|
||||||
|
|
||||||
To view slides, you'll need to enable the "Slides" plugin.
|
|
||||||
This can be done through the Settings => Core plugins.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Obsidian goals
|
|
||||||
|
|
||||||
- Longevity
|
|
||||||
- Foster network
|
|
||||||
- Personalized
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Longevity
|
|
||||||
|
|
||||||
- Local files on your hard disk
|
|
||||||
- Plain text, no proprietary format
|
|
||||||
- Markdown for maximum portability
|
|
||||||
- the most popular plain text format that can be edited in other apps
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Foster knowledge network
|
|
||||||
|
|
||||||
- [[Internal link|Internal links]]
|
|
||||||
- Link auto-complete
|
|
||||||
- See backlinks to and unlinked mentions of current note
|
|
||||||
- Graph view
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Personalized
|
|
||||||
|
|
||||||
- We don't believe in a single, opinionated solution would work for everyone
|
|
||||||
- Obsidian is plugin-based
|
|
||||||
- Enable or disable them based on your workflow
|
|
||||||
- Looking to allow third-party plugins to be developed after v1.0.0
|
|
Before Width: | Height: | Size: 46 KiB |
@ -1,3 +0,0 @@
|
|||||||
Your current version is your Obsidian version. This is the version number that you’ll see in the [[Title bar]] and the [[Vault switcher]].
|
|
||||||
|
|
||||||
You can have most of the new features and bug fixes by having an up-to-update current version. However, for some low-level updates, you might need to bring the [[Installer version]] up to date.
|
|
@ -1,7 +0,0 @@
|
|||||||
If you look closely in Settings -> About, you can find your current version and your installer version.
|
|
||||||
|
|
||||||
Installer version will not increase when you [[Update Obsidian|auto-update]], unlike the [[Current version]]. Your installer version will only increase when you install Obsidian with a new installer.
|
|
||||||
|
|
||||||
To grab the latest installer, please go to our [[official website]].
|
|
||||||
|
|
||||||
Most features can be delivered by auto-updating, but to update the engine for certain new features Obsidian, we encourage you to grab the latest installer from [our official website](https://obsidian.md) from time to time, when your current version is above the installer version by a lot, for example when your current version is 0.10.8 while installer version is 0.8.3.
|
|
@ -1,3 +0,0 @@
|
|||||||
The interface of Obsidian has been translated to various languages by [[Credits#Translators|our amazing volunteer translators]]. You can change the interface language either in Settings → About or in the [[Vault switcher]].
|
|
||||||
|
|
||||||
Don’t see your language in the list or seeing untranslated bits? Consider [[Contributing to Obsidian#Translating the docs|help us translate Obsidian into your language]].
|
|
@ -1,15 +0,0 @@
|
|||||||
### Base theme
|
|
||||||
|
|
||||||
Obsidian comes with two base themes, light and dark. This option sets the default color scheme your theme will use to either display its light or dark mode version.
|
|
||||||
|
|
||||||
### Custom theme
|
|
||||||
|
|
||||||
There are lots of community themes contributed by our amazing community that you can easily choose from.
|
|
||||||
|
|
||||||
You can easily tweak it by adding [[Add custom styles#Use Themes and or CSS snippets|CSS snippets]].
|
|
||||||
|
|
||||||
### Translucency
|
|
||||||
|
|
||||||
You can make the window translucent by enabling this option in the settings appearance tab. Currently this option is only available for Windows and macOS.
|
|
||||||
|
|
||||||
There is a known issue under Windows where dragging the window is extremely slow when translucency is enabled. This is due to a Windows bug. A Github issue tracking the status of a fix can be found here: https://github.com/riverar/sample-win32-acrylicblur/issues/2
|
|
@ -1,13 +0,0 @@
|
|||||||
Most hotkeys are customizable in Obsidian.
|
|
||||||
|
|
||||||
We only defined default hotkeys for the most commonly used commands, but if you frequently use a command, it would save you lots of time if you add a hotkey for it.
|
|
||||||
|
|
||||||
For a list of default hotkeys, [[Use hotkeys|see here]].
|
|
||||||
|
|
||||||
### Viewing hotkeys
|
|
||||||
|
|
||||||
The fastest way to see the hotkey set for a command is to find the command in [[Command palette]]. If there's a hotkey listed for that command, it's set.
|
|
||||||
|
|
||||||
### Setting hotkeys
|
|
||||||
|
|
||||||
To add a hotkey, remove a hotkey, or restore hotkeys to default, go to Settings => Hotkeys. Note that you can also filter the list, as the list of commands is quite long.
|
|
@ -1,23 +0,0 @@
|
|||||||
## Getting started
|
|
||||||
### Run on your local machine
|
|
||||||
|
|
||||||
Steps to run it on your local machine:
|
|
||||||
1. Clone this [Github repo](https://github.com/TuanManhCao/digital-garden)
|
|
||||||
2. Install [yarn](https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable) package manager
|
|
||||||
3. Copy all of your **markdown** file (`.md` only) and folder to `/posts/` **except** `/posts/index.md` file
|
|
||||||
4. Go to root folder of your project, run `yarn && yarn run dev`
|
|
||||||
5. Open this link in your browser http://localhost:3000/
|
|
||||||
|
|
||||||
If you prefer video content have a look at my walk through video in here
|
|
||||||
**Youtube**
|
|
||||||
|
|
||||||
### Publish to the internet
|
|
||||||
|
|
||||||
Setup environment (with Netlify)
|
|
||||||
1. Create your Github account and clone [my repository](https://github.com/TuanManhCao/digital-garden)
|
|
||||||
2. Create Netlify account and follow [this instruction](https://www.netlify.com/blog/2020/11/30/how-to-deploy-next.js-sites-to-netlify/)
|
|
||||||
|
|
||||||
|
|
||||||
Your normal workflow for publishing content, after initial setup is:
|
|
||||||
1. Simply writing your content in Obisidian (or your favourite Markdown editor)
|
|
||||||
2. Commit your changes and Push it to your Github repo
|
|
@ -1,39 +0,0 @@
|
|||||||
---
|
|
||||||
aliases: alias, aliases
|
|
||||||
---
|
|
||||||
|
|
||||||
Sometimes, you might want to refer to the same file with multiple names in different contexts. These alternative names are what we call "aliases".
|
|
||||||
|
|
||||||
For example, you might want to refer to your partner by their full name, first name, or a nickname. Or you might want to refer to "artificial intelligence" by its abbreviation "AI". If you know multiple languages, you may want to refer to the same concept with their name in the same language that the rest of the note is written in.
|
|
||||||
|
|
||||||
### Set aliases
|
|
||||||
|
|
||||||
Starting in 0.9.16, you're able to specify the "aliases" property in a note's [[YAML front matter]] like so:
|
|
||||||
|
|
||||||
```
|
|
||||||
---
|
|
||||||
aliases: [AI, Artificial Intelligence]
|
|
||||||
---
|
|
||||||
```
|
|
||||||
|
|
||||||
Please note that this section must be placed at the very top of a note to take effect.
|
|
||||||
|
|
||||||
In the future, we'll consider more user-friendly ways to manage aliases than manually writing them in front matter.
|
|
||||||
|
|
||||||
### Link with aliases
|
|
||||||
|
|
||||||
Once you've set aliases for a file, you can write `[[alias]]` to link to the original page. A redirect icon will show up in the auto-complete list like so:
|
|
||||||
|
|
||||||
![[Insert alises.png]]
|
|
||||||
|
|
||||||
An internal link with display text will get inserted like so: `[[Add aliases to note|alias]]`.
|
|
||||||
|
|
||||||
Note: the link to alias is **NOT** inserted as `[[alias]]` for interoperability, so that other software can recognize it as well.
|
|
||||||
|
|
||||||
### Find unlinked mentions
|
|
||||||
|
|
||||||
After you've set aliases for a note, you can find unlinked mentions by both its name and its aliases.
|
|
||||||
|
|
||||||
For example, after setting "AI" as an alias for "Artificial intelligence", you'll see mentions of "AI" in other files in the [[Backlinks]] section.
|
|
||||||
|
|
||||||
If you decide to link this mention, a link with display text set to the alias will be created for you. Following the example above, `AI` will become `[[Artificial intelligence|AI]]` once you click on the "Link" button.
|
|
@ -1,39 +0,0 @@
|
|||||||
When you want to add custom styles to your vault, there are two main ways to do this:
|
|
||||||
|
|
||||||
## Vault styles
|
|
||||||
|
|
||||||
### Themes
|
|
||||||
|
|
||||||
Themes allow you to toggle the appearance of your vault with a dropdown menu once they have been added to your vault's theme directory.
|
|
||||||
|
|
||||||
This configuration can be found in `Settings` => `Appearance` => `Themes` section of your vault settings.
|
|
||||||
|
|
||||||
### Create a custom theme
|
|
||||||
|
|
||||||
If you are creating your own theme, you can do this by:
|
|
||||||
|
|
||||||
1. Creating your custom theme CSS file in the themes directory `YOUR_VAULT/.obsidian/themes/YOUR_CUSTOM_THEME.css`
|
|
||||||
2. Enabling it in the theme dropdown under `Settings` => `Appearance` => `Themes`
|
|
||||||
|
|
||||||
For more information on how to customize styles of the graph, you can find more information in [[Graph view]].
|
|
||||||
|
|
||||||
### Use Themes and/or CSS snippets
|
|
||||||
|
|
||||||
You can find this configuration in `Settings` => `Appearance`. You can choose a community theme or set the theme you developed yourself. If you set a community theme, it will be automatically placed in the correct folder. If you develop your own theme, you have to put it in the shown folder location yourself.
|
|
||||||
|
|
||||||
CSS snippets are supposed to be small pieces of CSS for small changes you want to make/things you want to add. These snippets have to be placed in the shown directory.
|
|
||||||
|
|
||||||
You can go to the respective directories by clicking on the folder buttons. If the folder isn't created yet, it will be. In case your snippets or theme don't show up after you've put them there, you can click the button next to the folder icon to refresh the list.
|
|
||||||
|
|
||||||
## Obsidian Publish styles
|
|
||||||
|
|
||||||
At this time, [[Obsidian Publish]] is unable to automatically detect the vault's configured [[Add custom styles#Themes|theme]] and publish the respective styles.
|
|
||||||
|
|
||||||
A workaround for this limitation is to:
|
|
||||||
|
|
||||||
1. Go into `YOUR_VAULT/.obsidian/themes/CURRENT_THEME_FOLDER`;
|
|
||||||
2. Copy the primary CSS file `CURRENT_THEME.css` in the folder;
|
|
||||||
3. Paste it in the root directory of your vault (`YOUR_VAULT`);
|
|
||||||
4. Rename the CSS file as `publish.css`;
|
|
||||||
5. In the publish plugin, upload the `publish.css` file;
|
|
||||||
6. If your CSS doesn't take effect in a few minutes, try refreshing the browser cache as the stale CSS might have been cached.
|
|
@ -1,23 +0,0 @@
|
|||||||
If you've just opened Obsidian, you'll see two documents here. The one in the left pane is a text file, which you can edit using Markdown syntax. The one in the right pane is a _Preview_ of the same text file if you were to export it as HTML, or as a PDF document. Note that some things look different in Preview, and, most obviously, links are not in brackets. To follow a link, click on it in the Preview pane. You can follow links in the Editor pane as well, by holding down `Ctrl/Cmd` and clicking on the link. If you want to go back to the page you were on before, use the shortcut `Ctrl/Cmd-alt-LeftArrow`
|
|
||||||
|
|
||||||
Alternatively, the notes that link to the one you're currently on will be shown in the **Backlinks Panel** on the right (find more about Backlinks [[Backlinks|here.]])
|
|
||||||
|
|
||||||
If you get lost at any time, or just want to explore what else Obsidian can do, `Ctrl/Cmd-P` brings up the Command Palette. You can type commands there, like "Navigate back", and you'll see options filter to a short list, along with hotkey shortcuts if they have them.
|
|
||||||
|
|
||||||
At base, Obsidian is a tool for working with a bunch of markdown files that are stored on your computer. If you're not familiar with markdown, it's just plain text with some formatting that makes it powerful (for more on that, see [[Format your notes|Markdown]]) . As a result, if you want to use obsidian for keeping regular notes on just about anything, it will work great.
|
|
||||||
|
|
||||||
Let's say you want to write a note about your favorite band. Just type the name of the note surrounded by two square brackets, like `[[My Favorite Band]]`
|
|
||||||
|
|
||||||
Try it here (make sure you're typing in the Editor pane):
|
|
||||||
|
|
||||||
You'll notice that the text and the brackets turn blue. That means it's a link now. Click on that link in the Preview (or `Cmd-click` in the Editor), and you'll see a blank note. Write whatever you want there, and when you're done, come back here with `Cmd-alt-left`, or by clicking the name of this note ([[Basic note taking]]) in the **Backlinks** to the right. To learn more about navigating links, see [[Internal link]].
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
Notice that your new note showed up automatically in the File Explorer to the left. Obsidian automatically creates files when you click a link to a file that does not exist. This means you can `[[write naturally]]` about `[[whatever comes to mind]]` and then go back and create the new notes at your leisure. This makes Obsidian a fantastic tool for thinking freely in notes without having to worry about where to file them. And if you decide that a title is not what you actually meant, you can change the file name at the top of this window, and Obsidian will automatically update all links to it.
|
|
||||||
|
|
||||||
From there, you can make any kind of structure you want. Many people will want to make a `Table of Contents` note for listing major groups of notes. You can also use #tags to create categories (if you click that it will show you every note that contains #tags ). Really, the structure you build should be whatever works for you. We suggest you just start with what feels natural. Obsidian is flexible enough that it should be relatively simple to rearrange things later.
|
|
||||||
|
|
||||||
Be aware! The note you just created is in these Help documents, which will be overwritten on new releases. ==If you created anything you care to keep, it should be put into a different vault==. For details on how to do that, see [[Working with multiple vaults]].
|
|
||||||
|
|
||||||
If you want an example of a more advanced technique, you might look into the [sample workflows on our forum](https://forum.obsidian.md/t/example-workflows-in-obsidian/1093).
|
|
@ -1,15 +0,0 @@
|
|||||||
### Copy and paste
|
|
||||||
|
|
||||||
When you see something useful online, you can simply select the text, copy, and paste in Obsidian. Obsidian will try to convert it into proper Markdown so that it fits right in.
|
|
||||||
|
|
||||||
If you only wish to copy the text without the formatting, please use `Ctrl-Shift-V` on Windows and Linux and `Cmd-Shift-V` on macOS to do so.
|
|
||||||
|
|
||||||
### Use a clipper extension
|
|
||||||
|
|
||||||
Because Obsidian accepts any Markdown file, you can clip entire web pages by clipping to Markdown files and downloading them into your vault.
|
|
||||||
|
|
||||||
death_au's "MarkDownload" browser extension works well for this purpose. You can get it for:
|
|
||||||
|
|
||||||
- [Google Chrome](https://chrome.google.com/webstore/detail/markdownload-markdown-web/pcmpcfapbekmbjjkdalcgopdkipoggdi)
|
|
||||||
- [Firefox](https://addons.mozilla.org/en-GB/firefox/addon/markdownload/)
|
|
||||||
- [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/markdownload-markdown-w/hajanaajapkhaabfcofdjgjnlgkdkknm)
|
|
@ -1,4 +0,0 @@
|
|||||||
The settings can be found by clicking the gear in the bottom left corner, or by hitting `Ctrl/Cmd-,`. Most of them are fairly self-explanatory, but here are some notes that might be helpful.
|
|
||||||
|
|
||||||
- Most of the settings are toggle switches. If there are more details to a setting, it may have a gear next to the switch for additional settings. For example, the gear next to Spell Check reveals the custom dictionary, so you can remove words you may have accidentally added.
|
|
||||||
- Enabling plugins will cause their settings to appear in the list of tabs. For example, if you have the Daily Note plugin enabled, a setting tab will appear that allows you to further configure it.
|
|
@ -1,23 +0,0 @@
|
|||||||
Notes are created in a few ways, depending on your workflow:
|
|
||||||
|
|
||||||
1. **Note-first approach**. If you need to create a note, you can do so in [[File explorer]]. The keyboard shortcut is `Ctrl/Cmd+N`. Also, if you have the [[Command palette]] plugin enabled (it's on by default), press `Ctrl/Cmd-p` and type ‘new’, then select **********
|
|
||||||
|
|
||||||
1. **Link-first approach**. If you like to freely create notes, just use an [[Internal link]] to link to any note name (it doesn't need to exist at the time of creating the link). To write in the newly created note, simply click on the link name. It will be automatically created in your Vault and ready to type!
|
|
||||||
|
|
||||||
![[Pasted image 3.png]]
|
|
||||||
|
|
||||||
After creating it, the note title will appear in the internal link auto-completion, so you don't need to type out the note name every time. When you type `[[` a popup will come up showing all the notes in your vault. Just type until you see the one you want, and hit `Return` or click on it, and the name will be automatically filled in.
|
|
||||||
|
|
||||||
If you already have folders set up in [[File explorer]], you can right-click on a folder to create notes inside it:
|
|
||||||
|
|
||||||
![[Pasted image 4.png]]
|
|
||||||
|
|
||||||
There are also buttons at the top of the file explorer for creating new notes or folders.
|
|
||||||
|
|
||||||
Obsidian automatically saves your note two seconds after you stop typing, or if you close a pane. You can also manually save at any time by typing `Ctrl/Cmd-S`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Related:
|
|
||||||
|
|
||||||
- [[Rename notes]]
|
|
@ -1,77 +0,0 @@
|
|||||||
### Embed attachments
|
|
||||||
|
|
||||||
You can embed attachment files like images or audio in your notes. Use the `![[filename.png]]` syntax like so:
|
|
||||||
|
|
||||||
![[Engelbart.jpg]]
|
|
||||||
|
|
||||||
![[Excerpt from Mother of All Demos (1968).ogg]]
|
|
||||||
|
|
||||||
You can embed a PDF file in your notes with the same syntax. Additionally, you can write `![[My File.pdf#page=number]]` to open to that specific page of the PDF directly.
|
|
||||||
|
|
||||||
### Embed notes
|
|
||||||
|
|
||||||
You can embed a note also, with the same syntax:
|
|
||||||
|
|
||||||
![[Accepted file formats]]
|
|
||||||
|
|
||||||
### iframe
|
|
||||||
|
|
||||||
"iframe" is a way to embed a web page in another. It's useful because Markdown can accept HTML, which is a simple language to construct the web pages we see every day.
|
|
||||||
|
|
||||||
For example:
|
|
||||||
|
|
||||||
```html
|
|
||||||
<iframe src="https://www.youtube.com/embed/NnTvZWp5Q7o"></iframe>
|
|
||||||
```
|
|
||||||
|
|
||||||
Produces:
|
|
||||||
|
|
||||||
<iframe src="https://www.youtube.com/embed/NnTvZWp5Q7o"></iframe>
|
|
||||||
|
|
||||||
The basic syntax is:
|
|
||||||
|
|
||||||
```html
|
|
||||||
<iframe src="INSERT YOUR URL HERE"></iframe>
|
|
||||||
```
|
|
||||||
|
|
||||||
Some websites have quirks that don't allow you to embed them. For example, you can't embed a YouTube video by using its normal URL, but you can use its embed URL which is `https://www.youtube.com/embed/VIDEO_ID`.
|
|
||||||
|
|
||||||
If you want to embed a website, try searching for "{website} embed iframe".
|
|
||||||
|
|
||||||
For example, you can embed Twitter tweets like so as suggested by search results:
|
|
||||||
|
|
||||||
```html
|
|
||||||
<iframe
|
|
||||||
border=0
|
|
||||||
frameborder=0
|
|
||||||
height=250
|
|
||||||
width=550
|
|
||||||
src="https://twitframe.com/show?url=https%3A%2F%2Ftwitter.com%2Fjack%2Fstatus%2F20">
|
|
||||||
</iframe>
|
|
||||||
```
|
|
||||||
|
|
||||||
<iframe border=0 frameborder=0 height=250 width=550
|
|
||||||
src="https://twitframe.com/show?url=https%3A%2F%2Ftwitter.com%2Fjack%2Fstatus%2F20"></iframe>
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Developer notes
|
|
||||||
|
|
||||||
The syntax is inspired by Markdown's image syntax. We had two observations:
|
|
||||||
|
|
||||||
1. `[Image](link.png)` links to the image, but `![Image](link.png)` actually displays it.
|
|
||||||
|
|
||||||
2. The internal link syntax is based on this assumption: `[[My page]]` is a shortcut (or "syntactic sugar" if you will) for `[My page](My page)`.
|
|
||||||
|
|
||||||
To combine these two things, we can come up with a third pattern:`![[My page]]` should be equivalent to `![My page](My page)` , which by the image convention, if the title is the same as the link, should display it.
|
|
||||||
|
|
||||||
There are other implementations out there, for example Roam Research uses `{{embed: ((NODE_ID))}}`. We have also considered using the `((Page name))` syntax too, but we feel like `![[Page name]]` is more consistent, more familiar, and leaves more room so that the other symbols to have their own meanings.
|
|
||||||
|
|
||||||
#### Resize images
|
|
||||||
You can resize images using the following syntax:
|
|
||||||
|
|
||||||
For markdown images, use `![AltText|100x100](https://url/to/image.png)`
|
|
||||||
|
|
||||||
For embeds, use `![[image.png|100x100]]`
|
|
||||||
|
|
||||||
To have the image scale according to its aspect ratio, omit the height `![[image.png|100]]`
|
|
@ -1,15 +0,0 @@
|
|||||||
Folding text is an extremely powerful tool for outlining or writing, in order to focus on what you're working on.
|
|
||||||
|
|
||||||
To use folding, go to Settings (the gear icon on the left) => Editor and turn on `Fold indent` and `Fold heading`.
|
|
||||||
|
|
||||||
Obsidian has the ability to fold both markdown headers and indented lists. Note that at the top of this note there is a downward pointing arrow next to the title. If clicked, it will fold the entire note up, and if clicked again, it will show the note. This can be applied at multiple levels of markdown, as well as multiple levels of indentation in lists.
|
|
||||||
|
|
||||||
## By way of example
|
|
||||||
|
|
||||||
1. Categories of things
|
|
||||||
1. A subcategory
|
|
||||||
1. Another subcategory
|
|
||||||
1. An example of an item
|
|
||||||
1. A different, equally important item.
|
|
||||||
|
|
||||||
|
|
@ -1,438 +0,0 @@
|
|||||||
|
|
||||||
Obsidian is a Markdown-based note-taking and knowledge base app.
|
|
||||||
|
|
||||||
We currently support the formats below:
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Internal linking
|
|
||||||
|
|
||||||
```md
|
|
||||||
Link to a page: [[Internal link]].
|
|
||||||
```
|
|
||||||
|
|
||||||
Link to a page: [[Internal link]].
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Embeds
|
|
||||||
|
|
||||||
Embed another file (read more about [[Embed files]]). Here's an embedded section:
|
|
||||||
|
|
||||||
```md
|
|
||||||
![[Obsidian#What is Obsidian]]
|
|
||||||
```
|
|
||||||
|
|
||||||
![[Obsidian#What is Obsidian]]
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Headers
|
|
||||||
|
|
||||||
```md
|
|
||||||
# This is a heading 1
|
|
||||||
## This is a heading 2
|
|
||||||
### This is a heading 3
|
|
||||||
#### This is a heading 4
|
|
||||||
##### This is a heading 5
|
|
||||||
###### This is a heading 6
|
|
||||||
```
|
|
||||||
|
|
||||||
# This is a heading 1
|
|
||||||
## This is a heading 2
|
|
||||||
### This is a heading 3
|
|
||||||
#### This is a heading 4
|
|
||||||
##### This is a heading 5
|
|
||||||
###### This is a heading 6
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Emphasis
|
|
||||||
|
|
||||||
```md
|
|
||||||
*This text will be italic*
|
|
||||||
_This will also be italic_
|
|
||||||
```
|
|
||||||
|
|
||||||
*This text will be italic*
|
|
||||||
_This will also be italic_
|
|
||||||
|
|
||||||
```md
|
|
||||||
**This text will be bold**
|
|
||||||
__This will also be bold__
|
|
||||||
```
|
|
||||||
|
|
||||||
**This text will be bold**
|
|
||||||
__This will also be bold__
|
|
||||||
|
|
||||||
```md
|
|
||||||
_You **can** combine them_
|
|
||||||
```
|
|
||||||
|
|
||||||
_You **can** combine them_
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Lists
|
|
||||||
|
|
||||||
```md
|
|
||||||
- Item 1
|
|
||||||
- Item 2
|
|
||||||
- Item 2a
|
|
||||||
- Item 2b
|
|
||||||
|
|
||||||
1. Item 1
|
|
||||||
1. Item 2
|
|
||||||
1. Item 3
|
|
||||||
1. Item 3a
|
|
||||||
1. Item 3b
|
|
||||||
```
|
|
||||||
|
|
||||||
- Item 1
|
|
||||||
- Item 2
|
|
||||||
- Item 2a
|
|
||||||
- Item 2b
|
|
||||||
|
|
||||||
1. Item 1
|
|
||||||
1. Item 2
|
|
||||||
1. Item 3
|
|
||||||
1. Item 3a
|
|
||||||
1. Item 3b
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Images
|
|
||||||
|
|
||||||
```md
|
|
||||||
![Engelbart](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg)
|
|
||||||
```
|
|
||||||
|
|
||||||
![Engelbart](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg)
|
|
||||||
|
|
||||||
#### Resizing images
|
|
||||||
|
|
||||||
Example of this above image resized to 100 pixels wide:
|
|
||||||
|
|
||||||
```md
|
|
||||||
![Engelbart|100](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg)
|
|
||||||
```
|
|
||||||
|
|
||||||
![Engelbart|100](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Links
|
|
||||||
|
|
||||||
#### External links
|
|
||||||
|
|
||||||
Markdown style links can be used to refer to either external objects, such as web pages, or an internal page or image.
|
|
||||||
|
|
||||||
```md
|
|
||||||
http://obsidian.md - automatic!
|
|
||||||
[Obsidian](http://obsidian.md)
|
|
||||||
```
|
|
||||||
|
|
||||||
http://obsidian.md - automatic!
|
|
||||||
[Obsidian](http://obsidian.md)
|
|
||||||
|
|
||||||
#### Obsidian URI links
|
|
||||||
|
|
||||||
[[Using obsidian URI|Obsidian URI]] links can be used to open notes in Obsidian either from another Obsidian vault or another program.
|
|
||||||
|
|
||||||
For example, you can link to a file in a vault like so (please note the [[Using obsidian URI#Encoding|required encoding]]):
|
|
||||||
|
|
||||||
```md
|
|
||||||
[Link to note](obsidian://open?path=D:%2Fpath%2Fto%2Ffile.md)
|
|
||||||
```
|
|
||||||
|
|
||||||
[Link to note](obsidian://open?path=D:%2Fpath%2Fto%2Ffile.md)
|
|
||||||
|
|
||||||
You can link to a note by its vault name and file name instead of path as well:
|
|
||||||
|
|
||||||
```md
|
|
||||||
[Link to note](obsidian://open?vault=MainVault&file=MyNote.md)
|
|
||||||
```
|
|
||||||
|
|
||||||
[Link to note](obsidian://open?vault=MainVault&file=MyNote.md)
|
|
||||||
|
|
||||||
#### Escaping
|
|
||||||
|
|
||||||
If there are spaces in the url, they can be escaped by either using `%20` as a space, such as:
|
|
||||||
|
|
||||||
```md
|
|
||||||
[Export options](Pasted%20image)
|
|
||||||
```
|
|
||||||
|
|
||||||
[Export options](Pasted%20image)
|
|
||||||
|
|
||||||
Or you can enclose the target in `<>`, such as:
|
|
||||||
|
|
||||||
```md
|
|
||||||
[Slides Demo](<Slides Demo>)
|
|
||||||
```
|
|
||||||
|
|
||||||
[Slides Demo](<Slides Demo>)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Blockquotes
|
|
||||||
|
|
||||||
```md
|
|
||||||
> Human beings face ever more complex and urgent problems, and their effectiveness in dealing with these problems is a matter that is critical to the stability and continued progress of society.
|
|
||||||
|
|
||||||
\- Doug Engelbart, 1961
|
|
||||||
```
|
|
||||||
|
|
||||||
> Human beings face ever more complex and urgent problems, and their effectiveness in dealing with these problems is a matter that is critical to the stability and continued progress of society.
|
|
||||||
|
|
||||||
\- Doug Engelbart, 1961
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Inline code
|
|
||||||
|
|
||||||
```md
|
|
||||||
Text inside `backticks` on a line will be formatted like code.
|
|
||||||
```
|
|
||||||
|
|
||||||
Text inside `backticks` on a line will be formatted like code.
|
|
||||||
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Code blocks
|
|
||||||
|
|
||||||
Syntax highlight is supported with the language specified after the first set of backticks. We use prismjs for syntax highlighting, a list of supported languages can be found [at their site](https://prismjs.com/#supported-languages)
|
|
||||||
|
|
||||||
<pre><code>```js
|
|
||||||
function fancyAlert(arg) {
|
|
||||||
if(arg) {
|
|
||||||
$.facebox({div:'#foo'})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```</code></pre>
|
|
||||||
|
|
||||||
```js
|
|
||||||
function fancyAlert(arg) {
|
|
||||||
if(arg) {
|
|
||||||
$.facebox({div:'#foo'})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```md
|
|
||||||
Text indented with a tab is formatted like this, and will also look like a code block in preview.
|
|
||||||
```
|
|
||||||
|
|
||||||
Text indented with a tab is formatted like this, and will also look like a code block in preview.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Task list
|
|
||||||
|
|
||||||
```md
|
|
||||||
- [x] #tags, [links](), **formatting** supported
|
|
||||||
- [x] list syntax required (any unordered or ordered list supported)
|
|
||||||
- [x] this is a complete item
|
|
||||||
- [?] this is also a complete item (works with every character)
|
|
||||||
- [ ] this is an incomplete item
|
|
||||||
- [ ] tasks can be clicked in Preview to be checked off
|
|
||||||
```
|
|
||||||
|
|
||||||
- [x] #tags, [links](), **formatting** supported
|
|
||||||
- [x] list syntax required (any unordered or ordered list supported)
|
|
||||||
- [x] this is a complete item
|
|
||||||
- [?] this is also a complete item (works with every character)
|
|
||||||
- [ ] this is an incomplete item
|
|
||||||
- [ ] tasks can be clicked in Preview to be checked off
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Tables
|
|
||||||
|
|
||||||
You can create tables by assembling a list of words and dividing them with hyphens `-` (for the first row), and then separating each column with a pipe `|`:
|
|
||||||
|
|
||||||
```md
|
|
||||||
First Header | Second Header
|
|
||||||
------------ | ------------
|
|
||||||
Content from cell 1 | Content from cell 2
|
|
||||||
Content in the first column | Content in the second column
|
|
||||||
```
|
|
||||||
|
|
||||||
First Header | Second Header
|
|
||||||
------------ | ------------
|
|
||||||
Content from cell 1 | Content from cell 2
|
|
||||||
Content in the first column | Content in the second column
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
```md
|
|
||||||
Tables can be justified with a colon | Another example with a long title
|
|
||||||
:----------------|-------------:
|
|
||||||
because of the `:` | these will be justified
|
|
||||||
|
|
||||||
If you put links in tables, they will work, but if you use Piped Links, the pipe must be escaped with a `\` to prevent it being read as a table element.
|
|
||||||
```
|
|
||||||
|
|
||||||
Tables can be justified with a colon | Another example with a long title
|
|
||||||
:----------------|-------------:
|
|
||||||
because of the `:` | these will be justified
|
|
||||||
|
|
||||||
If you put links in tables, they will work, but if you use Piped Links, the pipe must be escaped with a `\` to prevent it being read as a table element.
|
|
||||||
|
|
||||||
```md
|
|
||||||
First Header | Second Header
|
|
||||||
------------ | ------------
|
|
||||||
[[Format your notes\|Formatting]] | [[Keyboard shortcuts\|hotkeys]]
|
|
||||||
```
|
|
||||||
|
|
||||||
First Header | Second Header
|
|
||||||
------------ | ------------
|
|
||||||
[[Format your notes\|Formatting]] | [[Use hotkeys\|hotkeys]]
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Strikethrough
|
|
||||||
|
|
||||||
```md
|
|
||||||
Any word wrapped with two tildes (like ~~this~~) will appear crossed out.
|
|
||||||
```
|
|
||||||
|
|
||||||
Any word wrapped with two tildes (like ~~this~~) will appear crossed out.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Highlighting
|
|
||||||
|
|
||||||
```md
|
|
||||||
Use two equal signs to ==highlight text==.
|
|
||||||
```
|
|
||||||
|
|
||||||
Use two equal signs to ==highlight text==.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Footnotes
|
|
||||||
|
|
||||||
```md
|
|
||||||
Here's a simple footnote,[^1] and here's a longer one.[^bignote]
|
|
||||||
|
|
||||||
[^1]: meaningful!
|
|
||||||
|
|
||||||
[^bignote]: Here's one with multiple paragraphs and code.
|
|
||||||
|
|
||||||
Indent paragraphs to include them in the footnote.
|
|
||||||
|
|
||||||
`{ my code }`
|
|
||||||
|
|
||||||
Add as many paragraphs as you like.
|
|
||||||
```
|
|
||||||
|
|
||||||
Here's a simple footnote,[^1] and here's a longer one.[^bignote]
|
|
||||||
|
|
||||||
[^1]: meaningful!
|
|
||||||
|
|
||||||
[^bignote]: Here's one with multiple paragraphs and code.
|
|
||||||
|
|
||||||
Indent paragraphs to include them in the footnote.
|
|
||||||
|
|
||||||
`{ my code }`
|
|
||||||
|
|
||||||
Add as many paragraphs as you like.
|
|
||||||
|
|
||||||
```md
|
|
||||||
You can also use inline footnotes. ^[notice that the carat goes outside of the brackets on this one.]
|
|
||||||
```
|
|
||||||
|
|
||||||
You can also use inline footnotes. ^[notice that the carat goes outside of the brackets on this one.]
|
|
||||||
|
|
||||||
### Math
|
|
||||||
|
|
||||||
```md
|
|
||||||
$$\begin{vmatrix}a & b\\
|
|
||||||
c & d
|
|
||||||
\end{vmatrix}=ad-bc$$
|
|
||||||
```
|
|
||||||
|
|
||||||
$$\begin{vmatrix}a & b\\
|
|
||||||
c & d
|
|
||||||
\end{vmatrix}=ad-bc$$
|
|
||||||
|
|
||||||
You can also do inline math like $e^{2i\pi} = 1$ .
|
|
||||||
|
|
||||||
Obsidian uses [Mathjax](http://docs.mathjax.org/en/latest/basic/mathjax.html). You can check which packages are supported in Mathjax [here](http://docs.mathjax.org/en/latest/input/tex/extensions/index.html).
|
|
||||||
|
|
||||||
### Comments
|
|
||||||
|
|
||||||
Use `%%` to enclose comments, which will be parsed as Markdown, but will not show up in the preview.
|
|
||||||
|
|
||||||
```md
|
|
||||||
Here is some inline comments: %%You can't see this text%% (Can't see it)
|
|
||||||
|
|
||||||
Here is a block comment:
|
|
||||||
%%
|
|
||||||
It can span
|
|
||||||
multiple lines
|
|
||||||
%%
|
|
||||||
```
|
|
||||||
|
|
||||||
Here is some inline comments: %%You can't see this text%% (can't see it in preview)
|
|
||||||
|
|
||||||
Here is a block comment: (can't see it in preview either)
|
|
||||||
%%
|
|
||||||
It can span
|
|
||||||
multiple lines
|
|
||||||
%%
|
|
||||||
|
|
||||||
### Diagram
|
|
||||||
|
|
||||||
Obsidian uses [Mermaid](https://mermaid-js.github.io/) to render diagrams and charts. Mermaid also provides [a helpful live editor](https://mermaid-js.github.io/mermaid-live-editor).
|
|
||||||
|
|
||||||
<pre><code>```mermaid
|
|
||||||
sequenceDiagram
|
|
||||||
Alice->>+John: Hello John, how are you?
|
|
||||||
Alice->>+John: John, can you hear me?
|
|
||||||
John-->>-Alice: Hi Alice, I can hear you!
|
|
||||||
John-->>-Alice: I feel great!
|
|
||||||
```</code></pre>
|
|
||||||
|
|
||||||
```mermaid
|
|
||||||
sequenceDiagram
|
|
||||||
Alice->>+John: Hello John, how are you?
|
|
||||||
Alice->>+John: John, can you hear me?
|
|
||||||
John-->>-Alice: Hi Alice, I can hear you!
|
|
||||||
John-->>-Alice: I feel great!
|
|
||||||
```
|
|
||||||
|
|
||||||
Obsidian supports linking to notes in Mermaid:
|
|
||||||
<pre><code>```mermaid
|
|
||||||
graph TD
|
|
||||||
|
|
||||||
Biology --> Chemistry
|
|
||||||
|
|
||||||
class Biology,Chemistry internal-link;
|
|
||||||
```</code></pre>
|
|
||||||
|
|
||||||
An easier way to do it is the following: ^376b9d
|
|
||||||
<pre><code>```mermaid
|
|
||||||
graph TD
|
|
||||||
|
|
||||||
A[Biology]
|
|
||||||
B[Chemistry]
|
|
||||||
|
|
||||||
A --> B
|
|
||||||
|
|
||||||
class A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z internal-link;
|
|
||||||
```</code></pre>
|
|
||||||
|
|
||||||
This way, all the note names (at least until `Z[note name]`) are all automatically assigned the class `internal-link` when you use this snippet.
|
|
||||||
|
|
||||||
If you use special characters in your note names, you need to put the note name in double quotes.
|
|
||||||
`"⨳ special character"`
|
|
||||||
It looks like this if you follow the [[Format your notes#^376b9d|second option]]:
|
|
||||||
`A["⨳ special character"]`
|
|
||||||
|
|
||||||
## Developer notes
|
|
||||||
|
|
||||||
We strive for maximum capability without breaking any existing formats, therefore we use a slightly unorthodox combination of flavors of markdown. It is broadly CommonMark, with the addition of some functionality from GitHub Flavored Markdown (GFM), some latex support, and our chosen embed syntax, which you can read more about at [[Accepted file formats]].
|
|
@ -1,52 +0,0 @@
|
|||||||
There are a few differences between the way various PKM and note taking systems work that mean moving between them can be a little complicated. For the most part, if whatever you're using can be converted to markdown, it will work fairly well within Obsidian. But some things, like tags and links, can be tricky.
|
|
||||||
|
|
||||||
On our Forum there is a [post collecting methods that other people have developed](https://forum.obsidian.md/t/meta-post-migration-workflows/768). Right now, it includes:
|
|
||||||
|
|
||||||
- [Import from Notion](https://forum.obsidian.md/t/import-from-notion/636)
|
|
||||||
- [Import from Notion (automated)](https://forum.obsidian.md/t/notion-2-obsidian-migration-instructions/2728)
|
|
||||||
- [Import from Evernote](https://forum.obsidian.md/t/import-from-evernote/108)
|
|
||||||
- [Import from OneNote](https://forum.obsidian.md/t/new-tool-for-migration-from-onenote-updated-and-improved-version/3055)
|
|
||||||
- [Import from Apple Notes](https://forum.obsidian.md/t/migrate-from-apple-notes-to-obsidian/732)
|
|
||||||
- [Import from Bear](https://forum.obsidian.md/t/import-from-bear-app/2284)
|
|
||||||
- [Import from Zkn3](https://forum.obsidian.md/t/migrating-from-zkn3-to-obsidian-without-losing-your-tags-and-internal-links-documentation/7457)
|
|
||||||
- [Import from TiddlyWiki 5](https://forum.obsidian.md/t/migrate-from-tiddlywiki-5-to-obsidian/731)
|
|
||||||
|
|
||||||
But if you don't see your system on this list, check out the forum post, someone may have solved your issue since this document was written.
|
|
||||||
|
|
||||||
Also of note, the makers of nvUltra, another markdown-based note-taking program, have a list on their website of [ways to export to nvUltra](https://nvultra.com/help/importing). In a lot of cases, these will be the same, or at least a helpful place to start.
|
|
||||||
|
|
||||||
## Built-in tools
|
|
||||||
|
|
||||||
### From Roam Research
|
|
||||||
|
|
||||||
If you have data in Roam, it's easy to export and play around with it in Obsidian.
|
|
||||||
|
|
||||||
> 1. Choose "Export all" in the menu:
|
|
||||||
> ![[Pasted image.png]]
|
|
||||||
|
|
||||||
> 2. Click the blue "Export all" button:
|
|
||||||
> ![[Pasted image 1.png]]
|
|
||||||
|
|
||||||
> 3. Unzip the "Roam-Export-xxxxxxxxxxxxx.zip" into a folder.
|
|
||||||
|
|
||||||
> 4. Click on the vault icon (the tooltip should say "Open another vault") on the bottom left corner in the app, and select "Open folder as vault".
|
|
||||||
> Pick the folder you just unzipped to.
|
|
||||||
|
|
||||||
> 5. Use our [[markdown format converter]] to convert Roam Research's Markdown format into Obsidian's format.
|
|
||||||
> It can be used turn `#tag` into Obsidian `[[links]]`.
|
|
||||||
> It can also convert `^^highlight^^` into `==highlight==`.
|
|
||||||
|
|
||||||
|
|
||||||
### From Bear
|
|
||||||
|
|
||||||
If you're importing from Bear, the [[Markdown format converter]] plugin has an option to convert `::highlight::` to `==highlight==`.
|
|
||||||
|
|
||||||
### Using Zettelkasten
|
|
||||||
|
|
||||||
If you've been using the Zettelkasten method to structure your notes, here's something you might want to know:
|
|
||||||
|
|
||||||
Links in Obsidian require a full match to the note name. This means that `[[202001010000]]` will not properly link to `[[202001010000 My Note]]`.
|
|
||||||
|
|
||||||
In order to fix that, you can use our [[markdown format converter]] to convert your Zettelkasten links into either `[[202001010000 My Note]]` or `[[202001010000 My Note|My Note]]`.
|
|
||||||
|
|
||||||
You might also be interested in the [[Zettelkasten prefixer]] plugin.
|
|
@ -1,19 +0,0 @@
|
|||||||
Internal links are the backbone of your knowledge network.
|
|
||||||
|
|
||||||
### Link to files
|
|
||||||
|
|
||||||
To create an internal link, simply type `[[`. This will prompt you with the list of notes you can link to. Use `Up arrow` and `Down arrow` to navigate the suggestion list and `Enter` to select the current highlighted link.
|
|
||||||
|
|
||||||
### Link to headings
|
|
||||||
|
|
||||||
You can also link to specific headers in files. Start typing a link like you would normally. When the note you want is highlighted, press `#` instead of `Enter` and you'll see a list of headings in that file. Continue typing or navigate with arrow keys as before, press `#`again at each subheading you want to add, and `Enter` to complete the link.
|
|
||||||
|
|
||||||
To make the link display different text than its real note name in Preview, use the vertical pipe (`Shift+|`) For example: [[Internal link|Custom Link Name in Preview!]] This can be combined with linking to headers, as in [[Folding#By way of example|Example of Folding]].
|
|
||||||
|
|
||||||
### Following Links
|
|
||||||
|
|
||||||
- To follow a link in the Preview pane, simply click on the link.
|
|
||||||
- To follow a link in a new panel from Preview, click while pressing `Ctrl/Cmd`''
|
|
||||||
- To follow a link in the Editor pane, click the link while pressing `Ctrl/Cmd`.
|
|
||||||
- To follow a link in a new panel from the Editor, click the link while pressing `Ctrl/Cmd-Shift`''
|
|
||||||
- To see a preview of the linked content without leaving the current note, enable the [[page preview]] plugin and a popup window will be displayed.
|
|
@ -1,39 +0,0 @@
|
|||||||
In Obsidian 0.9.5 or higher, in addition to [[Internal link#Link to headings|linking to headings]], you can also link to blocks.
|
|
||||||
|
|
||||||
### What is a block
|
|
||||||
|
|
||||||
A "block" can be a paragraph, a blockquote, a list item, etc. In general, anything that has empty lines before and after is a block. ^dcf64c
|
|
||||||
|
|
||||||
### Link to blocks
|
|
||||||
|
|
||||||
To link to a block in a specific file, first type `[[filename` to bring up a list of matched files. After selecting a file, type `^` and continue typing to search for blocks to link to.
|
|
||||||
|
|
||||||
Once you hit enter, a link to that block will be generated for you, in the format similar to `[[filename#^dcf64c]]`, where `dcf64c` is the block ID that was just generated for you.
|
|
||||||
|
|
||||||
If you're not sure which file the block is in, another method is to type `[[^^` and search for blocks in all files. This will search through all the blocks in your vault, so expect a bit of delay if your vault is large.
|
|
||||||
|
|
||||||
For example, [[#^dcf64c]] is a link to a block above.
|
|
||||||
|
|
||||||
### Embed or transclude blocks
|
|
||||||
|
|
||||||
Similar to [[Embed files|files embeds]], you can simply use `!` in front of a block link to embed it.
|
|
||||||
|
|
||||||
Here's an example:
|
|
||||||
|
|
||||||
![[#^dcf64c]]
|
|
||||||
|
|
||||||
### Manual block IDs
|
|
||||||
|
|
||||||
If you want human readable block IDs, you can manually put `^your-id` after a block. Make sure there's at least one space if you're putting the ID at end of a line.
|
|
||||||
|
|
||||||
To refer to complex blocks like tables, put the block ID on its own after the block, and make sure there is an empty line both before and after the block ID.
|
|
||||||
|
|
||||||
After you add the block ID manually, when you refer to that block, `your-id` will be used instead of a randomly generated block ID.
|
|
||||||
|
|
||||||
Note that only letters, numbers, and dashes are allowed in manual block IDs.
|
|
||||||
|
|
||||||
### Interoperability
|
|
||||||
|
|
||||||
Please be aware that block reference is not part of standard Markdown, but rather Obsidian's specific flavor of Markdown. That means these links will not work outside of Obsidian.
|
|
||||||
|
|
||||||
You can still find referenced block by searching for the block ID, although that's a rather manual process. The connection is not lost as long as you have software that can search in a folder.
|
|
@ -1,49 +0,0 @@
|
|||||||
## Add an attachment
|
|
||||||
|
|
||||||
There are several ways to include attachments in your notes:
|
|
||||||
|
|
||||||
1. Copy and paste;
|
|
||||||
2. Drag and drop;
|
|
||||||
3. Download or copy file to vault folder.
|
|
||||||
|
|
||||||
After being added, these attachment files are just normal files and can still be accessed through your file system.
|
|
||||||
|
|
||||||
Please note that only [[Accepted file formats]] are handled.
|
|
||||||
|
|
||||||
### Copy and paste
|
|
||||||
|
|
||||||
Pasting a local file from your system explorer or your clipboard will put the file into your vault.
|
|
||||||
|
|
||||||
This is very handy when combined with screenshot tools.
|
|
||||||
|
|
||||||
### Drag and drop
|
|
||||||
|
|
||||||
If you drag and drop a file from your file explorer, it will be copied to your vault as well.
|
|
||||||
|
|
||||||
### Download or copy to vault folder
|
|
||||||
|
|
||||||
This can work well when paired with [[Capture information#Use a clipper extension|clipper extensions]].
|
|
||||||
|
|
||||||
You can also download images from your browser into your vault folder directly for later reference.
|
|
||||||
|
|
||||||
## Change default attachment location
|
|
||||||
|
|
||||||
By default, new attachments will be dropped in the root of your vault. You can fine tune this setting in Settings => Files & Links => "Default location for new attachments".
|
|
||||||
|
|
||||||
### Choose a folder
|
|
||||||
|
|
||||||
You can choose a fixed folder to always place your attachments in. To do this, choose "In the folder specified below", and choose a folder in your vault in the new field that appears.
|
|
||||||
|
|
||||||
Alternatively, you can right click on a folder in [[File explorer]] and choose "Set as attachment folder".
|
|
||||||
|
|
||||||
### Same folder as current file
|
|
||||||
|
|
||||||
Sometimes, you may want the attachment files to always be in the same folder as the note you're working on. In this case, choose "Same folder as current file".
|
|
||||||
|
|
||||||
### Under the current folder
|
|
||||||
|
|
||||||
You can also choose to save attachments to a folder underneath the folder that the current file is in.
|
|
||||||
|
|
||||||
To do this, choose the "Subfolder under current folder" option, and write the name of the subfolder in the field that appears. For example, if you write `assets`, and your note is in `VAULT/folder/path/`, the attachments will be added to `VAULT/folder/path/assets` when you're working on this note.
|
|
||||||
|
|
||||||
You don't need to create the subfolder beforehand; if it doesn't exist, Obsidian will create it for you.
|
|
@ -1,5 +0,0 @@
|
|||||||
In obsidian, a document can be viewed in either edit mode or preview mode. In edit mode, you will see basic markdown rendering, but certain things, like code syntax highlighting and embedded files, will only show up in preview mode. Most notably, any images you embed will only be visible in preview mode.
|
|
||||||
|
|
||||||
To toggle between preview and edit mode, click the preview button in the title bar. In edit mode, it will appear as a page; in preview mode, a pencil. If you `Cmd/Ctrl`- click, the preview will be opened in a [[Linked pane]]. You can also toggle Preview Mode by hitting `Cmd/Ctrl-E`, but this hotkey can, of course, be changed.
|
|
||||||
|
|
||||||
If you want to default to opening in preview rather than edit mode, a toggle for that can be found in the [[Command palette]]. You can also set a [[Use hotkeys|Keyboard Shortcut]] for toggling between default states.
|
|
@ -1,9 +0,0 @@
|
|||||||
If you're already editing the note, you can rename it simply by editing the text in the title:
|
|
||||||
|
|
||||||
![[Pasted image 6.png]]
|
|
||||||
|
|
||||||
If you want to rename a note that you're not editing, go to [[file explorer]], right-click on the note or folder and choose "Rename":
|
|
||||||
|
|
||||||
![[Pasted image 7.png]]
|
|
||||||
|
|
||||||
An even faster way is to press `F2` while your mouse is over a note, which will take you straight to the renaming function.
|
|
@ -1,17 +0,0 @@
|
|||||||
### How auto-update works
|
|
||||||
|
|
||||||
Obsidian checks for update every 12 hours. Once an update is available, restarting the app will automatically bring you to the latest version.
|
|
||||||
|
|
||||||
You can check your current version, check for updates in Settings => About. You can also turn off "automatic updates" there.
|
|
||||||
|
|
||||||
### Insider build
|
|
||||||
|
|
||||||
If you're looking to update to the latest insider build, please refer to [[Insider builds#How to enable insider build|this guide]] on how to turn it on.
|
|
||||||
|
|
||||||
### Current version vs installed version
|
|
||||||
|
|
||||||
If you look closely in Settings => About, you can find your current version and your installer version.
|
|
||||||
|
|
||||||
Your current version is your Obsidian version. This is the version of the app on top of the engine (which is Electron). It will increase when you auto-update, but your installer version will not. Your installer version will only increase when you install Obsidian with a new installer.
|
|
||||||
|
|
||||||
Most features can be delivered by auto-updating, but to update the engine for certain new features Obsidian, we encourage you to grab the latest installer from [our official website](https://obsidian.md) from time to time, when your current version is above the installer version by a lot, for example when your current version is 0.10.8 while installer version is 0.8.3.
|
|
@ -1,5 +0,0 @@
|
|||||||
Hotkeys help you get work done faster. If you frequently per
|
|
||||||
|
|
||||||
If you have the [[Command palette]] enabled, You can use `Ctrl/Cmd+P` to bring it up, which will show you all currently available commands and hotkeys.
|
|
||||||
|
|
||||||
Most hotkeys can be [[Custom hotkeys|customized]] for your needs in Settings → Hotkeys.
|
|
@ -1,13 +0,0 @@
|
|||||||
Backlinks are one of the most powerful features of Obsidian. As a result, they can sometimes be a bit confusing, so here's some things that might help.
|
|
||||||
|
|
||||||
The Backlinks panel has two sections, Linked mentions and Unlinked mentions.
|
|
||||||
|
|
||||||
![[Backlinks.png]]
|
|
||||||
|
|
||||||
As you can see, from this document, there is currently one entry in each section. Under Linked mentions you can see that I made a link to this document in the [[Linked pane]] note. But, you can also see under Unlinked mentions that I wrote the name of this note but did not make it a link.
|
|
||||||
|
|
||||||
This can be a very powerful way of seeing connections between your notes that you did not know you were making when you wrote them. If, for example, you have a note named for a concept that comes up often in your field, you will be able to see easily when it is mentioned in other notes, and thus understand relationships between ideas you might not have otherwise.
|
|
||||||
|
|
||||||
If a reference appears in the Unlinked mentions, and you want to link it, hovering over the text will bring up a Link button. Clicking this will automatically surround the highlighted text in the referenced note with brackets, making it into an explicit link.
|
|
||||||
|
|
||||||
You can also create a separate, dedicated backlinks pane for a note under the More Options menu. This will be a [[Linked pane]] connected to the note, and can be moved around anywhere, as described in [[Pane layout]]. There's also an option to do this in the [[Command palette]].
|
|
@ -1,3 +0,0 @@
|
|||||||
If you hold down `Alt` (`option` on mac) and click, you can create multiple cursors. This can be useful when modifying a lot of lines in the same way, for example putting `-` at the beginning of multiple lines to turn them into a list, or appending `[[` to a series of links you've copied from elsewhere.
|
|
||||||
|
|
||||||
To cancel multiple cursors, either click somewhere in the note (without a modifier key), or hit escape.
|
|
@ -1,53 +0,0 @@
|
|||||||
You can edit and view multiple files in Obsidian.
|
|
||||||
|
|
||||||
To effectively use split view, you only need to know a few things:
|
|
||||||
|
|
||||||
##### 1. ==Use Ctrl/Cmd key== when you want to open things in a new pane.
|
|
||||||
|
|
||||||
By default, when you click something, it will open in the active pane. The active pane is marked with highlighted bar under the title, and its title is more visible than the inactive panes.
|
|
||||||
|
|
||||||
To open files in new panes, hold down `Ctrl/Cmd` while you click in Preview mode (`Shift + Ctrl/Cmd` in Edit mode). This applies to a number of places, including [[file explorer]], [[backlinks]] (both links and unlinked mentions), [[search]] results, and [[graph view]]. It also applies to buttons; instead of previewing in the current pane, you can `Cmd+click` the preview button to preview in a new pane. When using the Quick Switcher, holding down `Cmd/Ctrl`when hitting `Enter` will open in a new pane.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
##### 2. You can also create new panes by ==splitting==.
|
|
||||||
|
|
||||||
To create other layouts, you can split the current pane in half either horizontally or vertically. Do this with the menu at the top right of the pane, use the command palette, or set a [[Use hotkeys]].
|
|
||||||
|
|
||||||
![[Pasted image 16.png]]
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
##### 3. If you want a sticky pane that does not get replaced even when it's active, ==pin it==.
|
|
||||||
|
|
||||||
This is great if you're working on something and want to use the other panes as temporary reference panes. Pin it to make sure it never gets replaced.
|
|
||||||
|
|
||||||
![[Pasted image 17.png]]
|
|
||||||
|
|
||||||
Pinned panes will have a highlighted pin icon instead of a grey one.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
##### 4. Use ==linked panes== for previewing.
|
|
||||||
|
|
||||||
When creating [[Linked pane|linked panes]], `Ctrl/Cmd+click` the preview or edit button when a Markdown file is open.
|
|
||||||
|
|
||||||
When linked to another pane, the panes' scroll position will be synced, and if you open a file in one pane, the other pane will open the same file.
|
|
||||||
|
|
||||||
[[Linked pane|Linked panes]] will be marked with a link icon. You can hover the link to see which pane it's linked to, or click the icon to release it, so that they are no longer linked.
|
|
||||||
|
|
||||||
For more information see [[Linked pane|linked panes]].
|
|
||||||
|
|
||||||
![[Pasted image 18.png]]
|
|
||||||
|
|
||||||
##### 5. Panes can be ==rearranged by dragging==.
|
|
||||||
|
|
||||||
Grab the icon in the upper left corner to arrange them however you need. For detailed information, see [[Pane layout]].
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
Useful tips:
|
|
||||||
|
|
||||||
1. You can resize the panes however you want, by dragging the resize handle that's between each pane.
|
|
||||||
|
|
||||||
2. Your file layout, including their sizes, will be remembered when you close the app, so don't worry about having to set them up every time you open the app!
|
|
@ -1,19 +0,0 @@
|
|||||||
Each collection of notes in Obsidian is known as a Vault. A Vault consists of a folder, and any sub-folders within it. Right now, you're looking at the `Obsidian Help` Vault, which is just a folder of files included with Obsidian.
|
|
||||||
|
|
||||||
You can open another Vault anywhere on your computer, and it will retain its own individual [[Core plugins|Plugins]] and [[Add custom styles|custom styling]]. This is useful, for example, if you have one Vault where you keep notes but a different one in which you do long-form writing.
|
|
||||||
|
|
||||||
A new or existing Vault can be opened from the button just above the Settings gear.
|
|
||||||
|
|
||||||
![[Vault picker.png]]
|
|
||||||
|
|
||||||
You have the option to either open an existing folder of markdown files, create a new vault (which essentially just creates a new folder that you will put markdown files into), or opening a special vault containing these help files. The Help Vault is stored in a special Obsidian directory (see [[How Obsidian stores data]]), but aside from that, it's a directory of files just like any other.
|
|
||||||
|
|
||||||
[[Internal link|Internal Links]] are not shared across Vaults. If you have one Vault inside another Vault, this can get confusing, so we recommend not doing that.
|
|
||||||
|
|
||||||
Always remember, a Vault is just a collection of markdown files. You can use whatever file management techniques you would normally to move them around on your file system, and Obsidian will automatically refresh to keep up.
|
|
||||||
|
|
||||||
### Transfer settings between vaults
|
|
||||||
|
|
||||||
All settings, themes, and plugins are stored in the `.obsidian` folder under your vault. If you copy this folder from one vault to another, all the settings will be transferred as well. You may need to restart Obsidian for all of the settings to take effect.
|
|
||||||
|
|
||||||
This folder is hidden in some operating systems. Notably, you can use `Cmd-Shift-Period` to show hidden files on macOS in order to reveal the `.obsidian` folder.
|
|
@ -1,22 +0,0 @@
|
|||||||
Tags are a very useful way of grouping multiple notes so they are easy to find. A tag is essentially a clickable search through your entire Vault for a term. For example, clicking on #tags will bring up a search with all notes that contain that tag. Most people use them for broad categories of things, like a class you might be taking notes in or a type of idea. Some Zettelkasten practitioners like to use them as "entry points" for thinking about connected ideas. But ultimately, they are flexible enough that you can use them in any way you would like.
|
|
||||||
|
|
||||||
### Tag pane
|
|
||||||
|
|
||||||
If you have the [[Tag pane]] plugin enabled, you will see a list of all tags that are used across all of your notes, sorted by frequency. Clicking on any of those will activate that search.
|
|
||||||
|
|
||||||
This will allow you to search exact matches of a tag. For example, when clicking , as per usual, but if you want to find all instances of `maintag` with all subtags, you can still use the [[Search]] to look for `#maintag`. This is useful in cases where you have subcategories of things but you also want to be able to easily find all instances of the higher category.
|
|
||||||
|
|
||||||
### Allowed characters
|
|
||||||
|
|
||||||
Spaces are not allowed in tags. So, if you want to have multiple words in a tag, you can use these formats:
|
|
||||||
|
|
||||||
- CamelCase: #TwoWords
|
|
||||||
- Underscore: #two_words
|
|
||||||
- Dash: #two-words
|
|
||||||
|
|
||||||
The only symbols allowed are:
|
|
||||||
|
|
||||||
1. `_` (underscore) and `-` (dash) to separate words;
|
|
||||||
2. `/` (forward slash) for [[Tag pane#Nested tags|nested tags]].
|
|
||||||
|
|
||||||
Numbers are allowed in the tag, ==as long as the tag is not purely numeric==. For example, #1984 does not form a valid tag, but #y1984 is valid.
|
|
@ -1,45 +0,0 @@
|
|||||||
The Android app is now publicly available, and a link to the Play store listing can be found at https://obsidian.md/mobile
|
|
||||||
|
|
||||||
## Where are my vaults stored?
|
|
||||||
|
|
||||||
On Android, the Obsidian home folder is stored in the public documents folder under `Documents/Obsidian`. The public `Documents` folder is typically stored in SD card or emulated storage.
|
|
||||||
|
|
||||||
Any folder in this home folder will be considered a vault. If you sync or copy a vault folder into this directory, it can be recognized when you open Obsidian.
|
|
||||||
|
|
||||||
## Sync
|
|
||||||
|
|
||||||
On Android, you may choose to use [[Obsidian Sync]] to synchronize your files, or use any third party sync provider that can perform sync in the background.
|
|
||||||
|
|
||||||
### Obsidian Sync
|
|
||||||
|
|
||||||
As with Obsidian desktop, we provide our built-in paid [[Obsidian Sync]] service.
|
|
||||||
|
|
||||||
To setup a synced vault through Obsidian Sync, first create a new empty local vault. You should name it the same as your desktop app to make [[Using obsidian URI|inter-vault URIs]] work.
|
|
||||||
|
|
||||||
Once the empty vault is open, open the left sidebar, tap the settings button, and setup Obsidian Sync just like you did on Desktop:
|
|
||||||
|
|
||||||
1. Login to your Obsidian account in the Account tab.
|
|
||||||
2. Enable the Sync core plugin.
|
|
||||||
3. Open settings, and choose the "Sync" tab under "Plugin options".
|
|
||||||
4. Choose the remote vault to sync with.
|
|
||||||
5. Keep the app open until all your files have synced over.
|
|
||||||
|
|
||||||
To view the sync status of Obsidian Sync, swipe to pull out the right drawer, and you should see the status indicator just like it shows on the desktop app. Tap on it to get more information, such as viewing the sync log to debug any issues.
|
|
||||||
|
|
||||||
### Third party sync
|
|
||||||
|
|
||||||
You can also use your preferred sync solution to keep the local folder on your phone in sync with other devices.
|
|
||||||
|
|
||||||
There are apps on the Play Store that let you sync a folder on your phone with other devices, for example [Dropsync](https://play.google.com/store/apps/details?id=com.ttxapps.dropsync) or [FolderSync](https://play.google.com/store/apps/details?id=dk.tacit.android.foldersync.lite).
|
|
||||||
|
|
||||||
## Storage Permission
|
|
||||||
|
|
||||||
When starting Obsidian, you may notice that it prompts for permission to access your device's documents and media.
|
|
||||||
|
|
||||||
In an ideal world, we'd prefer to only ask for access rights to the vault folders you choose. However, Android's privacy-friendly file permission API (also known as "scoped storage") has a few restrictions that makes it impossible for Obsidian to function properly.
|
|
||||||
|
|
||||||
The two biggest roadblocks are:
|
|
||||||
- Scoped storage performs many extra permission checks for every single file access, causing significant performance degradation when opening and using Obsidian.
|
|
||||||
- Scoped storage does not provide a way to watch for external changes, which is critical when using Obsidian with a third-party synchronization tool.
|
|
||||||
|
|
||||||
Google specifically gives instructions for developers of this kind of apps a special permission. Obsidian belongs to two categories in the list of exceptions: "document management apps", and "on-device file search". [Read more about it here.](https://developer.android.com/training/data-storage/manage-all-files)
|
|
@ -1,57 +0,0 @@
|
|||||||
Names are not listed by amount of contribution, but alphabetically (or at least we try!).
|
|
||||||
|
|
||||||
### Dev team
|
|
||||||
|
|
||||||
- Licat (Shida Li)<span class='flair mod-pop'>Obsidian office cat</span>
|
|
||||||
- Silver (Erica Xu)<span class='flair mod-pop'>Team Little Silvers</span>
|
|
||||||
|
|
||||||
### Moderators
|
|
||||||
|
|
||||||
- anthonyg ([Anthony Gold](https://www.anthonypgold.com/))<span class='flair mod-pop' style='background-color:#F1C40F;color:#000;'>Team Gold</span><span class='flair mod-pop'>Think Tank</span>
|
|
||||||
- argentum<span class='flair mod-pop'>Team Little Silvers</span><span class='flair mod-pop'>Linux master</span><span class='flair mod-pop'>Zotero master</span>
|
|
||||||
- cotemaxime ([Maxime Côté](https://www.maximecote.me/))<span class='flair mod-pop'>Linux master</span>
|
|
||||||
- death_au ([website](https://about.me/death.au))<span class='flair mod-pop'>the Magician</span><span class='flair mod-pop' style='background-color:#F1C40F;color:#000;'>Team Gold</span>
|
|
||||||
- Eleanor ([Eleanor Konik](https://eleanorkonik.com))<span class='flair mod-pop'>Halp Obsidian turned me into a dev</span>
|
|
||||||
- koala<span class='flair mod-pop'>Extreme Bug Finder</span>
|
|
||||||
- Leah ([Leah Ferguson](http://leahferguson.com))<span class='flair mod-pop'>Roll for initiative!</span><span class='flair mod-pop'>Non-techy Apple geek</span>
|
|
||||||
- liam ([Liam Cain](https://liamca.in/)) <span class='flair mod-pop'>Maker of Calendar</span><span class='flair mod-pop'>Plugin API Master</span><span class='flair mod-pop'>Volcano Veteran</span>
|
|
||||||
- mediapathic ([Steen Comer](http://mediapathic.net/))<span class='flair mod-pop'>Bad Cop</span>
|
|
||||||
- nickmilo ([Nick Milo](https://publish.obsidian.md/lyt-kit/_START+HERE))<span class='flair mod-pop'>Mappy McMapster</span>
|
|
||||||
- Reggie<span class='flair mod-pop' style='background-color:#0a8c28'>Go green or go home</span>
|
|
||||||
- rigmarole ([Chris Lesage](http://rigmarolestudio.com))<span class='flair mod-pop'>Forum master</span>
|
|
||||||
- ryanjamurphy ([Ryan](https://fulcra.design/) [J. A. Murphy](https://axle.design/))<span class='flair mod-pop'>That funny guy</span><span class='flair mod-pop'>Apple Fanboy</span><span class='flair mod-pop'>Forum master</span>
|
|
||||||
- Sam Baron ([website](https://sambaron.coach/))<span class='flair mod-pop'>Think Tank</span><span class='flair mod-pop'>Forum master</span>
|
|
||||||
- Santi Younger ([website](https://santiyounger.com/))<span class='flair mod-pop'>Forum master</span>
|
|
||||||
- WhiteNoise<span class='flair mod-pop'>Think Tank</span><span class='flair mod-pop'>Zotero master</span><span class='flair mod-pop'>Bug report exterminator</span>
|
|
||||||
- Carl the Turtle<span class='flair mod-pop'>Online 24/7</span><span class='flair mod-pop'>Easily triggered</span><span class='flair mod-pop'>Good and pure</span><span class='flair mod-pop' style='background-color:#0a8c28'>Go green or go home</span>
|
|
||||||
|
|
||||||
### Translators
|
|
||||||
|
|
||||||
- Andrea Brandi (Italian)
|
|
||||||
- canzi-teacher, 蚕子 (Chinese Simplified)
|
|
||||||
- Daniel Mathiot (French)
|
|
||||||
- Henrik Falk (Danish)
|
|
||||||
- JxhnnyUt8h (Russian)
|
|
||||||
- k-andzhanovskii, Константин Анджановский (Russian)
|
|
||||||
- lisachev, Сергей Лисачев (Russian)
|
|
||||||
- mafsi, (Patrick Danilevici) (Română)
|
|
||||||
- taksas, 中山 拓海 (Japanese)
|
|
||||||
- VKondakoff, Валерий Кондаков (Russian)
|
|
||||||
- yo-goto, ぱだわん (Japanese)
|
|
||||||
|
|
||||||
### Builds
|
|
||||||
|
|
||||||
- jstone for maintaining our builds on flathub
|
|
||||||
- adamgibbins and ran-dall for maintaining our builds on homebrew
|
|
||||||
|
|
||||||
### Documentation
|
|
||||||
|
|
||||||
The first version of the help vault was written by Silver. Later part of it was written by [@mediapathic](http://mediapathic.net), with a big help from Reggie. We also got corrections from the many pairs of eyes in the Discord and forum community.
|
|
||||||
|
|
||||||
We now accept pull requests to the help vault in [our docs repo](https://github.com/obsidianmd/obsidian-docs/).
|
|
||||||
|
|
||||||
##### Add your name
|
|
||||||
|
|
||||||
If you're a translator, please make a pull request to add "Your Name (contributed language)" to the section above. Please keep the list of names alphabetical, thanks!
|
|
||||||
|
|
||||||
If your name is not in English and can't be alphabetically listed, use this format: `your-github-username, [your name in your language] (Language name)`.
|
|
@ -1,39 +0,0 @@
|
|||||||
## Public release
|
|
||||||
|
|
||||||
The mobile apps are now officially publicly available. You can find the download links for the public versions at https://obsidian.md/mobile
|
|
||||||
|
|
||||||
## Documentation
|
|
||||||
|
|
||||||
For more details on how to use Obsidian for Mobile, including guides for setting up sync, see [[Obsidian Mobile]].
|
|
||||||
|
|
||||||
## Insider builds
|
|
||||||
|
|
||||||
If you're a holder of the [[Catalyst license]], you may wish to join our [[Insider builds|insider builds]] for mobile.
|
|
||||||
|
|
||||||
To keep feedback and releases centralized as we don't have the capacity to debug and collect feedback via email, we ask Catalyst users who would like to beta test to go through the following steps:
|
|
||||||
|
|
||||||
### Step 1: join our Discord
|
|
||||||
|
|
||||||
First of all, please [join our Discord](https://discord.gg/veuWUTm).
|
|
||||||
|
|
||||||
### Step 2: claim your Catalyst badge to access \#insider-build-mobile channel
|
|
||||||
|
|
||||||
If you don't have your badge yet, [[Catalyst license#Discord badge|you can get it in your Account page]].
|
|
||||||
|
|
||||||
### Step 3: get the app via TestFlight (iOS) or APK (Android)
|
|
||||||
|
|
||||||
Once you get your badge, you should be able to see the `#insider-build-mobile` channel along with regular channels like `#general` and `#publish`.
|
|
||||||
|
|
||||||
To find the instructions for installing the mobile apps, go to `#insider-build-mobile`, and open pinned messages.
|
|
||||||
|
|
||||||
On Discord web and desktop, you can open pinned messages of a channel by clicking on the pushpin icon near the search bar at the top. On Discord mobile, you'll need to swipe left to reveal the right sidebar and tap on the pushpin icon at the top.
|
|
||||||
|
|
||||||
For the iOS app, look for the TestFlight link. Make sure to open the link on your iPhone or iPad, rather than on your computer. For the Android app, install the APK from the latest pinned messages if there are several of them.
|
|
||||||
|
|
||||||
## How do I provide feedback?
|
|
||||||
|
|
||||||
Before reporting an issue or submitting a feature request, please visit [the list of known issues on our forum](https://forum.obsidian.md/t/list-of-known-issues/14286) to see what's already known and on the roadmap.
|
|
||||||
|
|
||||||
The current group being rolled out can access the `#insider-build-mobile` channel on Discord as well as the new Mobile category on the forum.
|
|
||||||
|
|
||||||
To keep track of bug reports and feature requests, please direct them to the forum as usual. Thank you for trying out our beta!
|
|
@ -1,7 +0,0 @@
|
|||||||
# Obsidian for Android
|
|
||||||
|
|
||||||
See [[Android app]].
|
|
||||||
|
|
||||||
# Obsidian for iOS
|
|
||||||
|
|
||||||
See [[iOS app]].
|
|
@ -1,60 +0,0 @@
|
|||||||
## What is Obsidian
|
|
||||||
|
|
||||||
Obsidian is a both a Markdown editor and a knowledge base app.
|
|
||||||
|
|
||||||
Used in the most basic way, you can edit and preview Markdown files. But its true power lies in managing densely networked knowledge base.
|
|
||||||
|
|
||||||
How do we start creating a network, you ask? Let's first start making some [[Internal link|internal links]]!
|
|
||||||
|
|
||||||
## How we're different
|
|
||||||
|
|
||||||
==*We want you to own and control your data*==
|
|
||||||
|
|
||||||
We believe in plain text for something as important as your knowledge base. You don't want to put your own brain over someone else's neck, do you? Treat your second brain the same way.
|
|
||||||
|
|
||||||
Sync is only a utility to facilitate working on multiple devices, the data will always primarily live on your hard disk.
|
|
||||||
|
|
||||||
When the file system replaces the cloud, you get flexible options to work with your files: you can back them up with Dropbox, use Git to do versioning, or encrypt your disk for security. Whatever works on your file system will work on your Obsidian knowledge base.
|
|
||||||
|
|
||||||
==*Links are first-class citizens*==
|
|
||||||
|
|
||||||
Links and connections are crucial to discovering the relations between what we know.
|
|
||||||
|
|
||||||
Obsidian greatly values this, and encourages it with [[Internal link]] and [[Graph view]], among other things.
|
|
||||||
|
|
||||||
As John Locke puts it...
|
|
||||||
|
|
||||||
> The acts of the mind, wherein it exerts its power over simple ideas, are chiefly these three:
|
|
||||||
> 1. Combining several simple ideas into one compound one, and thus all complex ideas are made.
|
|
||||||
> 2. The second is bringing two ideas, whether simple or complex, together, and setting them by one another so as to take a view of them at once, without uniting them into one, by which it gets all its ideas of relations.
|
|
||||||
> 3. The third is separating them from all other ideas that accompany them in their real existence: this is called abstraction, and thus all its general ideas are made.
|
|
||||||
|
|
||||||
\- John Locke, An Essay Concerning Human Understanding (1690)
|
|
||||||
|
|
||||||
Hierarchy gives us No. 1, and linking gives us No. 2. We're still unsure what No. 3 entails in the context of note-taking, but it might have something to do with programming or macros.
|
|
||||||
|
|
||||||
==*Your own toolkit*==
|
|
||||||
|
|
||||||
Note-taking is a highly personal activity. Naturally there is no single all-encompassing solution for everyone.
|
|
||||||
|
|
||||||
Instead of providing you with an opinionated and assembled product, [[Obsidian]] gives you a foundation and numerous functional building blocks to discover and build your own solution.
|
|
||||||
|
|
||||||
The foundation is to be able to view files, edit them, and search them. For the minimalist, that's enough.
|
|
||||||
|
|
||||||
On top of that, you can add isolated, independent building blocks to add features to your note-taking:
|
|
||||||
|
|
||||||
- If you're taking class notes, [[Audio recorder]] and LaTeX math might be useful;
|
|
||||||
|
|
||||||
- If you're taking work notes, [[Slides]] and [[Backlinks]] may come in handy;
|
|
||||||
|
|
||||||
- If you're a researcher, [[Graph view]] and [[Word count]] might be essential to your toolkit.
|
|
||||||
|
|
||||||
We don't expect plugins to be the silver bullet to solve all the problems, but it does get us closer than a monolith solution, without all the features that you don't need cluttering the interface.
|
|
||||||
|
|
||||||
We support [[Customizing CSS|custom CSS]] and have a [[Community plugins|beta plugin API]], which will enable even more interface customization and support less common use cases.
|
|
||||||
|
|
||||||
## Follow our development
|
|
||||||
|
|
||||||
Obsidian is in public beta right now. We have [a roadmap](https://trello.com/b/Psqfqp7I/obsidian-roadmap) that you can check out.
|
|
||||||
|
|
||||||
Our Twitter handle is [@obsdmd](https://twitter.com/obsdmd), feel free to follow. We mostly tweet about product updates.
|
|
@ -1,7 +0,0 @@
|
|||||||
Obsidian’s official website is at https://obsidian.md/.
|
|
||||||
|
|
||||||
It’s useful for:
|
|
||||||
|
|
||||||
1. Grabbing the latest installer if your [[Installer version]] is too low;
|
|
||||||
2. Register an account if you want to purchase [[Catalyst license]], [[Commercial license]], [[Obsidian Sync]], or [[Obsidian Publish]];
|
|
||||||
3. Playing a [quiz game](https://obsidian.md/quiz) if you’re confident with your knowledge of the community plugins and themes.
|
|
@ -1,81 +0,0 @@
|
|||||||
The iOS app is now publicly available, and a link to the app store listing can be found at https://obsidian.md/mobile
|
|
||||||
|
|
||||||
## Where are my vaults stored?
|
|
||||||
|
|
||||||
If you choose, you can store your vaults in iCloud Drive. These vaults can be found in your iCloud Drive folder, under an app folder named "Obsidian" that shows the Obsidian logo.
|
|
||||||
|
|
||||||
If you choose not to use iCloud for a vault, then it will be stored in the sandboxed file system of the Obsidian app. The local vaults are accessible from any other apps that support picking a folder from the file system. As such, apps like Working Copy can be used to sync with Obsidian's local vaults.
|
|
||||||
|
|
||||||
==Be aware that if you choose to store your vault locally, they will be automatically deleted by iOS when you uninstall Obsidian's app.==
|
|
||||||
|
|
||||||
## Sync
|
|
||||||
|
|
||||||
### Quick start
|
|
||||||
|
|
||||||
If you already have a vault on your desktop, here's the two ways to sync your vault to mobile and access it:
|
|
||||||
|
|
||||||
- [[#iCloud Drive Sync]]
|
|
||||||
- [[#Obsidian Sync]]
|
|
||||||
|
|
||||||
The two current officially supported sync solutions are iCloud and Obsidian Sync.
|
|
||||||
Working Copy (git) is another alternative that has been tested to work with Obsidian on iOS.
|
|
||||||
|
|
||||||
Currently, there is **no** known support for the following sync services on iOS yet:
|
|
||||||
- Dropbox
|
|
||||||
- Google Drive
|
|
||||||
- OneDrive
|
|
||||||
- Syncthing
|
|
||||||
|
|
||||||
If you find out a way to sync using these services on iOS with Obsidian, we would be glad if you can join our Discord server and teach us how to set it up.
|
|
||||||
|
|
||||||
In theory, any third party sync providers that can provide background-sync for a specific folder on your device should be able to work, but we are not aware of any other than Working Copy. This is due to the limitations of the highly complex mechanism of cross-app file sharing in iOS, unlike Android which allows easy cross-app file sharing. Because of this, most third party sync providers don't have a proper implementation for background sync on iOS.
|
|
||||||
|
|
||||||
Currently Obsidian does not support third party sync providers that expose a virtual file system through FileProvider. We will be attempting this in the future as an improvement.
|
|
||||||
|
|
||||||
### Obsidian Sync
|
|
||||||
|
|
||||||
You can follow the same steps as Android's sync as shown below, making sure that you create a non-iCloud folder as we do not recommend using both Obsidian Sync and iCloud Sync concurrently, which has been reported to cause data loss due to [[Obsidian Sync#Third party sync|race conditions]].
|
|
||||||
|
|
||||||
![[Android app#Obsidian Sync]]
|
|
||||||
|
|
||||||
### iCloud Drive Sync
|
|
||||||
|
|
||||||
To setup a **new** synced vault through iCloud Drive:
|
|
||||||
|
|
||||||
1. Start the iOS app and choose "Create a new vault";
|
|
||||||
2. On desktop, using the "Open another vault" option, point to the new vault location in iCloud.
|
|
||||||
|
|
||||||
To setup an **existing** vault to be synced through iCloud Drive:
|
|
||||||
|
|
||||||
1. Start the app and choose "Create a new vault";
|
|
||||||
2. Name it the same as your desktop vault to make [[Using obsidian URI|inter-vault URIs]] work;
|
|
||||||
3. Wait for iCloud to sync this empty folder to your desktop;
|
|
||||||
4. Copy and paste everything under your vault to this empty folder, this will now be your synced folder location;
|
|
||||||
5. On desktop, using the "Open another vault" option, point to the new vault location in iCloud;
|
|
||||||
6. Wait for iCloud to sync everything to your mobile device.
|
|
||||||
|
|
||||||
### Working Copy
|
|
||||||
|
|
||||||
You can alternatively setup Working Copy to use Git to sync your vault on iOS. To do this, you should create an empty local vault on your device first, then you can "Setup Folder Sync" and select a local vault inside the Obsidian app. Then, you can manually commit & push.
|
|
||||||
|
|
||||||
### Third party sync support
|
|
||||||
|
|
||||||
Many users asks why Obsidian for Mobile doesn't support their preferred sync solution. Here's a brief explanation on the current state of mobile sync support.
|
|
||||||
|
|
||||||
The thing about Obsidian that's different from other apps like 1Writer and iA Writer is that Obsidian works on top of a vault rather than a single note. Many of the core Obsidian functionality depend on the whole vault and all the files inside, such as the link auto-complete, image embedding, tag pane, backlinks, and all the cross-note functionality.
|
|
||||||
|
|
||||||
In contrast, most Markdown editing apps simply "open" a single note, let the user perform edits, then save the note back. Because of this, the OS and third party sync providers typically only provide an API for accessing/working with a single file, but not so much for working with a vault (folder of files with potentially subfolders).
|
|
||||||
|
|
||||||
For sync, a regular markdown editor app can simply implement the basic "download file when you open a selected file" and "upload the file back when you press save". Obsidian has to download the whole vault to be useful, and keep track of all the modified files (like for example, when you perform a file rename, we might update a bunch of other files for links that has changed due to the rename). On top of that, we need a way to monitor for changes through the sync solution to be able to update our internal caches when files change, to provide accurate links.
|
|
||||||
|
|
||||||
Keeping all that in sync with a third party sync provider would be quite tedious - and this is actually part of the reason why most sync providers don't make a proper sync client for mobile and you have to use a third party app (like DropSync or FolderSync) to do it. Unfortunately, such apps don't exist on iOS because of app sandboxing.
|
|
||||||
|
|
||||||
## Known issues
|
|
||||||
|
|
||||||
### iCloud folder on macOS
|
|
||||||
|
|
||||||
If you find yourself unable to drag & drop things into the iCloud folder in Finder on macOS, please download the latest Obsidian Desktop release from https://obsidian.md as it contains a fix for this issue. Once it's installed, running the app should automatically cause iCloud to update the folder permissions. If this does not work right away, you may need to restart your machine.
|
|
||||||
|
|
||||||
### Paste menu sometimes not appearing
|
|
||||||
|
|
||||||
Some users runs into an issue where tapping on the cursor does not show the paste menu. As a workaround, you can use the three-finger tap gesture to trigger a global edit menu which can be used to paste into the text.
|
|
@ -1,9 +0,0 @@
|
|||||||
Audio recorder is a plugin that lets you make a recording without leaving Obsidian. It's useful for class and meeting notes when you can't catch up for some reason, or for recording important discussions so you don't miss any details.
|
|
||||||
|
|
||||||
To use, simply click on the microphone icon in the left panel:
|
|
||||||
|
|
||||||
![[Pasted image 8.png]]
|
|
||||||
|
|
||||||
The microphone will become colored while it's actively recording.
|
|
||||||
|
|
||||||
Click on it again to finish recording. The audio file is now saved in your [[vault]] and an embed the recording will be added to the end of your current note.
|
|
@ -1,12 +0,0 @@
|
|||||||
The backlinks plugin shows how the current note is referenced in other notes.
|
|
||||||
|
|
||||||
After enabling it, you'll see the backlink count in the status bar.
|
|
||||||
|
|
||||||
In the right side bar (if it's expanded), you should also see a panel that shows where the current note gets linked:
|
|
||||||
|
|
||||||
![](Backlinks.png)
|
|
||||||
|
|
||||||
|
|
||||||
![[Pasted image 9.png]]()
|
|
||||||
|
|
||||||
Upon expanding the "Unlinked mentions" section, you can also see where the name of the note gets mentioned, but not explicitly linked (in other words, mentioned without the square brackets).
|
|
@ -1,18 +0,0 @@
|
|||||||
The Command Palette is enabled by default, as it is a very useful way to access nearly all the features of Obsidian without having to remember key strokes. Type `Ctrl/Cmd+P` to activate, then simply type in the name of the command. If a command has a hotkey, it will appear in on the right side.
|
|
||||||
|
|
||||||
Custom shorcuts can be added to the Command Palette in Settings => Hotkeys. Click on the `*` icon to the right of each key listed and type whatever key combination you would like.
|
|
||||||
|
|
||||||
### Settings
|
|
||||||
|
|
||||||
#### Pinned commands
|
|
||||||
|
|
||||||
You can set a few pinned commands that will appear at top of the command palette. This lets you choose them without typing anything. It's a good place to put your most frequently used commands.
|
|
||||||
|
|
||||||
Pinned commands are managed on the Command palette options screen under Plugin Options. You can add pinned commands by entering the name in the "New pinned command" field. After you pick a command and hit `Enter`, the command will be added to the list above. You can reorder the list or delete existing pinned commands in the list.
|
|
||||||
|
|
||||||
### Usage tips
|
|
||||||
|
|
||||||
- To see a list of all commands along with their shortcut, don't type anything into the prompt. The arrow keys will move up and down the list, and `Return` will activate the command.
|
|
||||||
|
|
||||||
- Search in the command palette is fuzzy, so you can type part of the word to get matches. For example, you can use `trm` to search for "Toggle read mode".
|
|
||||||
|
|
@ -1,33 +0,0 @@
|
|||||||
One of the most powerful aspects of [[Obsidian]] is the ability to add new functionality via plugins. It comes with several already, and many more are in development.
|
|
||||||
|
|
||||||
You can also build your own Obsidian plugin. See [[Community plugins]].
|
|
||||||
|
|
||||||
Plugins can be managed through the "Settings" button on the bottom left. Some of them have settings of their own that can be configured by clicking on the gear that appears next to each plugin when it is activated.
|
|
||||||
|
|
||||||
### Current list of core plugins
|
|
||||||
|
|
||||||
1. [[File explorer]]
|
|
||||||
1. [[Search]]
|
|
||||||
1. [[Quick switcher]]
|
|
||||||
1. [[Graph view]]
|
|
||||||
1. [[Backlinks]]
|
|
||||||
1. [[Outgoing links]]
|
|
||||||
1. [[Tag pane]]
|
|
||||||
1. [[Page preview]]
|
|
||||||
1. [[Daily notes]]
|
|
||||||
1. [[Templates]]
|
|
||||||
1. [[Note composer]]
|
|
||||||
1. [[Command palette]]
|
|
||||||
1. [[Starred notes]]
|
|
||||||
1. [[Markdown format converter]]
|
|
||||||
1. [[Zettelkasten prefixer]]
|
|
||||||
1. [[Random note]]
|
|
||||||
1. [[Outline]]
|
|
||||||
1. [[Word count]]
|
|
||||||
1. [[Slides]]
|
|
||||||
1. [[Audio recorder]]
|
|
||||||
1. [[Open in default app]]
|
|
||||||
1. [[Workspaces]]
|
|
||||||
1. [[File recovery]]
|
|
||||||
1. [[Publish]]
|
|
||||||
1. [[Obsidian Sync|Sync]]
|
|
@ -1,10 +0,0 @@
|
|||||||
Daily Notes will create a new note that is automatically named with the current date. If it already exists, it will open that note. This is a useful way to create a daily log, todo list, or a list of links to notes that you have created on a specific day.
|
|
||||||
|
|
||||||
The date format and default folder for Daily Notes can be set in Settings => Plugins, by clicking the gear next to the name. The default date format is "YYYY-MM-DD" (ISO format). This format means that a list of daily notes, listed in alphabetical order, will also be in chronological order.
|
|
||||||
|
|
||||||
You can create a Daily Note either by clicking on the calendar icon in the left panel, or with the [[Command palette]]. You can also set a hotkey in [[Use hotkeys]].
|
|
||||||
|
|
||||||
### Templates
|
|
||||||
You can define a [[Templates|template file]] for daily notes. This file will be copied into your daily note when it's created, so it's a good place to put tags or links you use every day.
|
|
||||||
|
|
||||||
For the daily notes plugin, `{{date}}` and `{{time}}` do not work. Please use `{{date:YYYY-MM-DD}}` and `{{time:HH:mm}}` in your template.
|
|
@ -1,13 +0,0 @@
|
|||||||
The File explorer shows [[Accepted file formats|the list of files Obsidian can recognize]] in your vault. You can open notes, [[create notes]] and folders, and [[rename notes]] in it. Right clicking on a note or directory in the File explorer will bring up appropriate options, such as renaming or making a copy. This is also the best way to set your default folder for when you [[Embed files]].
|
|
||||||
|
|
||||||
It's one of the crucial plugins that we recommend you to keep enabled.
|
|
||||||
|
|
||||||
### Usage tips
|
|
||||||
|
|
||||||
1. If the list of files is cluttering the interface though, you can close it:
|
|
||||||
|
|
||||||
![[Pasted image 15.png]]
|
|
||||||
|
|
||||||
2. You can drag and drop to put one file into another folder.
|
|
||||||
|
|
||||||
3. You can use the sort icon at the top to sort files by file name or last modified time.
|
|
@ -1,42 +0,0 @@
|
|||||||
File recovery is a core plugin to help you recover your data in case of all kind of accidents - user error, power outage, or misbehaving plugins and scripts.
|
|
||||||
|
|
||||||
File recovery is default to enabled, because it's too late to enable when you've already lost data.
|
|
||||||
|
|
||||||
## How it works
|
|
||||||
|
|
||||||
### Snapshots
|
|
||||||
|
|
||||||
As long as this plugin is enabled, full snapshots of what you're working on get saved at fixed intervals (you can configure this interval). Snapshots get deleted after a fixed amount of retention time.
|
|
||||||
|
|
||||||
This process is automatic. By default, snapshots are made every 5 minutes, and snapshots are kept for 7 days.
|
|
||||||
|
|
||||||
### Recovering
|
|
||||||
|
|
||||||
In case of data loss, here's how you can find saved snapshots:
|
|
||||||
|
|
||||||
1. Open settings;
|
|
||||||
2. Open the "File recovery" tab under "Plugin options";
|
|
||||||
3. Click on the "View" button in "Snapshots" section;
|
|
||||||
4. In the search bar on the left, enter the name of file you want to recover. If the file name does not show it, it means no snapshots were saved for that file;
|
|
||||||
5. After selecting a file in the dropdown, a list of snapshots will appear on the left. Select the one you want to recover;
|
|
||||||
6. The content of that snapshot will show up on the right. You can click "Copy to clipboard" to copy the whole thing, or cherry-pick some of the content.
|
|
||||||
|
|
||||||
## Options
|
|
||||||
|
|
||||||
### Snapshot interval
|
|
||||||
|
|
||||||
Minimal number of minutes between two snapshots. Default is 5 minutes.
|
|
||||||
|
|
||||||
### History length
|
|
||||||
|
|
||||||
Number of days to keep snapshots around for. Default is 7 days.
|
|
||||||
|
|
||||||
### Clear history
|
|
||||||
|
|
||||||
You also have the option to wipe all history. ==Please be careful as this action is irreversible.==
|
|
||||||
|
|
||||||
## Data storage
|
|
||||||
|
|
||||||
The file recovery data is stored in [[How Obsidian stores data#System directory|system directory]] in case of vault malfunctioning.
|
|
||||||
|
|
||||||
Please note that vaults are identified by their absolute path. If you've moved vault, you will need to move it back to its previous position in order to restore the snapshots while the vault was there.
|
|
@ -1,70 +0,0 @@
|
|||||||
Shows a graph representation of the [[Internal link|internal links]] between your notes.
|
|
||||||
|
|
||||||
Notes with more notes referencing it appear as bigger nodes on the graph.
|
|
||||||
|
|
||||||
![[Pasted image 10.png]]
|
|
||||||
|
|
||||||
### Visualization tips
|
|
||||||
|
|
||||||
- You can hover each node to highlight its connections, fading everything else.
|
|
||||||
- You can drag nodes around to rearrange the graph. This may be helpful if some nodes are overlaying others.
|
|
||||||
|
|
||||||
### Navigation tips
|
|
||||||
|
|
||||||
- To zoom, you can use mouse wheel scroll, as well as the `+` and `-` keys.
|
|
||||||
- To pan around, drag the background or use the keyboard arrow keys.
|
|
||||||
- Hold `Shift` while navigating with the keyboard to speed things up.
|
|
||||||
|
|
||||||
### Custom CSS
|
|
||||||
|
|
||||||
Since the graph is rendered using `<canvas>` and WebGL, [[Customizing CSS|CSS]] is unable to affect things like nodes and links. To customize graph view, we have provided a way to convert CSS colors into WebGL commands.
|
|
||||||
|
|
||||||
#### The following CSS classes are supported:
|
|
||||||
|
|
||||||
```
|
|
||||||
.graph-view.color-fill
|
|
||||||
.graph-view.color-fill-tag (theme-dependent)
|
|
||||||
.graph-view.color-fill-attachment (theme-dependent)
|
|
||||||
.graph-view.color-arrow
|
|
||||||
.graph-view.color-circle
|
|
||||||
.graph-view.color-line
|
|
||||||
.graph-view.color-text
|
|
||||||
.graph-view.color-fill-highlight
|
|
||||||
.graph-view.color-line-highlight
|
|
||||||
.graph-view.color-fill-unresolved
|
|
||||||
```
|
|
||||||
|
|
||||||
\* theme-dependent means you may have to add `.theme-dark` or `.theme-light` to style it for different themes. See [[#Custom CSS#Defaults]] for explanation.
|
|
||||||
|
|
||||||
#### The following CSS rules are supported:
|
|
||||||
|
|
||||||
```css
|
|
||||||
.graph-view.color-class {
|
|
||||||
/* Supports all CSS color directives, like #HEX, rgb and rgba */
|
|
||||||
color: #FFF;
|
|
||||||
color: #FFFFFF;
|
|
||||||
color: rgb(0, 0, 0);
|
|
||||||
color: rgba(0, 0, 0, 1);
|
|
||||||
/* Opacity (similar to rgba) will make the color transparent */
|
|
||||||
opacity: 0.5;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Defaults:
|
|
||||||
|
|
||||||
These CSS rules are the ones Obsidian use by default. You may override any of them using an identical or [more specific](https://developer.mozilla.org/en-US/docs/Web/CSS/Specificity) CSS rule. This applies especially to `.color-fill-tag` and `.color-fill-attachment` As a last resort, add `!important` to the end of your rule.
|
|
||||||
|
|
||||||
```css
|
|
||||||
.graph-view.color-fill,
|
|
||||||
.theme-dark .graph-view.color-fill-tag,
|
|
||||||
.theme-light .graph-view.color-fill-tag,
|
|
||||||
.theme-dark .graph-view.color-fill-attachment,
|
|
||||||
.theme-light .graph-view.color-fill-attachment,
|
|
||||||
.graph-view.color-arrow,
|
|
||||||
.graph-view.color-circle,
|
|
||||||
.graph-view.color-line,
|
|
||||||
.graph-view.color-text,
|
|
||||||
.graph-view.color-fill-highlight,
|
|
||||||
.graph-view.color-line-highlight,
|
|
||||||
.graph-view.color-fill-unresolved {}
|
|
||||||
```
|
|
@ -1,15 +0,0 @@
|
|||||||
It allows you to convert from other variations of Markdown format and link convention to Obsidian format.
|
|
||||||
|
|
||||||
Right now you can convert:
|
|
||||||
|
|
||||||
- Roam #tags to [[tags]]
|
|
||||||
- Roam `^^highlight^^` to `==highlight==`
|
|
||||||
- Bear `::highlight::` to `==highlight==`.
|
|
||||||
- Zettelkasten `[[UID]]` links to full links `[[UID File Name]]`
|
|
||||||
- Zettelkasten `[[UID]]` links to pretty links `[[UID File Name|File Name]]`, which will show up as just `File Name`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Related
|
|
||||||
|
|
||||||
- [[Format your notes]]
|
|
@ -1,42 +0,0 @@
|
|||||||
The Note composer plugin allows you to easily merge two note or extract part of a note into its own note.
|
|
||||||
|
|
||||||
## Merge
|
|
||||||
|
|
||||||
When working with the file, you can choose "Merge entire file with..." in the More Options menu.
|
|
||||||
|
|
||||||
Alternatively, you can open [[Command palette]] and invoke the command "Note composer: Merge current file with another file...".
|
|
||||||
|
|
||||||
This will bring up a menu to choose a file to merge into. Once you confirm the merge, all links to the current note will be updated to the merged file.
|
|
||||||
|
|
||||||
The current note will be merged to the bottom by default; you can use `Shift-Enter` instead of `Enter` to merge it to the top.
|
|
||||||
|
|
||||||
## Extract
|
|
||||||
|
|
||||||
When selecting text, you can either right click on it, select "Extract current selection", or use the [[Command palette]] to find the "Note composer: Extract current selection..." command.
|
|
||||||
|
|
||||||
Similar to merging, this will bring up a menu to choose a file to extract into. If no result can be found, a new note will be created. If you want to create a new note instead of using the first result, press `Ctrl-Enter` (or `Cmd-Enter` on macOS).
|
|
||||||
|
|
||||||
## Options
|
|
||||||
|
|
||||||
Note Composer has a few helpful plugin options.
|
|
||||||
|
|
||||||
### Text after moving
|
|
||||||
|
|
||||||
After you extract a piece of text, it's often a good idea to leave a link to the new file. By default, a link is created. But you can also change this option to have an embed created for you, or insert nothing at all.
|
|
||||||
|
|
||||||
### Template file
|
|
||||||
|
|
||||||
When merging or extracting, instead of just sending over the content, you can also apply a template file to it.
|
|
||||||
|
|
||||||
This template file can contain the following variables:
|
|
||||||
|
|
||||||
- `{{content}}`: this is where the content will be placed. If you do not include this variable, the content will automatically be placed at the bottom of the template.
|
|
||||||
- `{{fromTitle}}`: the name of the note where the new note comes from.
|
|
||||||
- `{{newTitle}}`: the title of the new file. Convenient if you prefer to have a heading at the top of the file that's the same as the file name.
|
|
||||||
- `{{date:FORMAT}}`: you can add multiple dates with your custom format. For example, you can do `{{date:YYYY-MM-DD}}` and it will resolve to the date or time when the note gets created.
|
|
||||||
|
|
||||||
### Confirm file merge
|
|
||||||
|
|
||||||
Merging files will delete the file and is destructive, so by default we ask for your confirmation. If you prefer, you can choose to skip this confirmation.
|
|
||||||
|
|
||||||
In case you accidentally merged something and want to get it back, consider using the [[File recovery]] plugin to recover it.
|
|
@ -1,5 +0,0 @@
|
|||||||
Opens the current file with default app on your computer. You can access it at the top right corner of the file top bar:
|
|
||||||
|
|
||||||
![[Pasted image 5.png]]
|
|
||||||
|
|
||||||
It's useful for editing images or annotating PDFs, among other things.
|
|
@ -1,17 +0,0 @@
|
|||||||
The Outgoing Links plugin shows the links from the current note at a glance, as well as potential links to be made. If you're familiar with the [[Backlinks]] plugin, you can think of outgoing links as the opposite direction of backlinks.
|
|
||||||
|
|
||||||
After enabling the plugin, you should see a new pane in the right sidebar, which contains two sections: "Links" and "Unlinked mentions".
|
|
||||||
|
|
||||||
### Links
|
|
||||||
|
|
||||||
The Links sections show links to other files, headings, and blocks. Clicking on a link will take you to that file.
|
|
||||||
|
|
||||||
Each type will have its own icon for you to distinguish them; links to files that are not created yet have special icons.
|
|
||||||
|
|
||||||
Underneath the title, you can also see the folder path of each file.
|
|
||||||
|
|
||||||
### Unlinked mentions
|
|
||||||
|
|
||||||
If any text in the current note matches the name or [[Add aliases to note|alias]] of another note in your vault, you can see the context, highlighted match, and a button to Link it under "Unlinked mentions".
|
|
||||||
|
|
||||||
When you hover over the button, it will show the full path of the file if it's not in the vault root. If you have multiple files of the same name, this can help you distinguish them.
|
|
@ -1 +0,0 @@
|
|||||||
The outline plugin shows the list of headings for the current note, and allows you to navigate to another section by clicking on a heading.
|
|
@ -1,5 +0,0 @@
|
|||||||
Page preview lets you preview a page when hovering an internal link, without needing to actually navigate to that page.
|
|
||||||
|
|
||||||
![[Pasted image 13.png]]
|
|
||||||
|
|
||||||
This works on the preview pane. In the editor, you can hover a link while holding `Ctrl/Cmd`, which will open the preview too.
|
|
@ -1,93 +0,0 @@
|
|||||||
The Publish plugin lets you publish notes from your vault onto your site, all from within the Obsidian app.
|
|
||||||
|
|
||||||
For more information about the Obsidian Publish™ service, what's included, how it works, and privacy, see the [[Obsidian Publish]] add-on service.
|
|
||||||
|
|
||||||
### Enable the plugin
|
|
||||||
|
|
||||||
From within Obsidian => Settings => Plugin, enable the Publish plugin. After that, a Publish icon (which looks like a paper plane) will appear in the ribbon pane.
|
|
||||||
|
|
||||||
Once enabled, you can also set a hotkey for this option, or use the command palette to access it.
|
|
||||||
|
|
||||||
### Set up and Configure your site
|
|
||||||
|
|
||||||
Within the Publish plugin, you'll see an option to create a site by entering a unique site ID. Once published, your site will be available at `https://publish.obsidian.md/{site-id}`.
|
|
||||||
|
|
||||||
After creating a unique site ID, you'll have the option to give your site a name, select a home page, set a theme, and toggle various components such as graph view, table of contents, etc. You can toggle these options by clicking on the gear icon near your site name at the top of the Publish plugin.
|
|
||||||
|
|
||||||
### Select files for publishing
|
|
||||||
|
|
||||||
After setting up your site, you can now publish your notes!
|
|
||||||
|
|
||||||
With a fresh, empty site, all your notes will appear under the "New" section, meaning they are new to your site. At this point, you may choose which files you want to publish, and then click the "Publish" button.
|
|
||||||
|
|
||||||
==Privacy note: Obsidian Publish has no awareness (nor retention) of any notes you choose not to publish (nor any notes you subsequently remove from your published site).==
|
|
||||||
|
|
||||||
#### YAML support for Publish
|
|
||||||
|
|
||||||
As of 0.12.12, you can use YAML to flag notes to be published. (You can read more about YAML in Obsidian [[YAML front matter|here]].)
|
|
||||||
|
|
||||||
If you set `publish: true`, then new files will be automatically selected the next time you publish changes.
|
|
||||||
|
|
||||||
If you set `publish: false`, then the file will not be visble when publishing changes, and will not show up in new/changed files. If this file had been previously published, you will see an option to delete it instead.
|
|
||||||
|
|
||||||
If you do not use YAML to flag publish files, the default behaviour is to automatically select changed files, but not new files.
|
|
||||||
|
|
||||||
### Make changes
|
|
||||||
|
|
||||||
As you make changes to notes that have already been published, those changes will be automatically selected when you open the Publish plugin dialog. You may uncheck any files you wish not to publish to your site.
|
|
||||||
|
|
||||||
### Change site options
|
|
||||||
|
|
||||||
You can change various site options by clicking on the gear icon near your site name when in the "Publish changes" dialogue.
|
|
||||||
|
|
||||||
#### Metadata
|
|
||||||
|
|
||||||
In this section, you can set site name, home page file (the file visitors see when they land on your site), and manage custom domain (please see [[Obsidian Publish#Custom domain|this guide]] to set up your custom domain).
|
|
||||||
|
|
||||||
#### Appearance
|
|
||||||
|
|
||||||
Here you can change the theme between light and dark.
|
|
||||||
|
|
||||||
If you want more customization, you can look into setting up [[Obsidian Publish#Custom CSS|custom CSS]] and [[Obsidian Publish#Favicon|favicon]].
|
|
||||||
|
|
||||||
#### Reading experience
|
|
||||||
|
|
||||||
In this section, you can:
|
|
||||||
|
|
||||||
- Enable a special mode called "sliding windows" that looks like [Andy Matuschak's notes](https://notes.andymatuschak.org/);
|
|
||||||
- Enable page preview on hover like when using [[Page preview]] plugin in the app;
|
|
||||||
- Configure whether you want readable line length and strict line breaks.
|
|
||||||
|
|
||||||
#### Components
|
|
||||||
|
|
||||||
Your site comes with a few components that you can toggle on or off. These include:
|
|
||||||
|
|
||||||
- File explorer (default on)
|
|
||||||
- Local graph (default on)
|
|
||||||
- Outline (default off)
|
|
||||||
- Backlink at the bottom (default off)
|
|
||||||
- Search bar (default off, requires file explorer)
|
|
||||||
|
|
||||||
#### Security
|
|
||||||
|
|
||||||
Here you can set passwords to protect your site. Once set, all visitors need to enter one of the passwords to enter your site.
|
|
||||||
|
|
||||||
Multiple passwords facilitate sharing with multiple groups. When you no longer wish to share with one group of visitors, you can simply delete that password. Each password can be named for your convenience as well.
|
|
||||||
|
|
||||||
As of 2021/01/20, all notes on your site are protected by the same set of passwords.
|
|
||||||
|
|
||||||
### Add linked notes
|
|
||||||
|
|
||||||
The "Add linked" button allows you to include for publishing any notes in your vault that are referenced (linked to) by any currently selected notes. This is a good way to ensure there are no dead links on your published site.
|
|
||||||
|
|
||||||
By way of example, let's assume you select Note A for publishing. Supposing Note A has links to Note P, Note Q, and Note R, then if you click the "Add linked" button, Notes P, Q, and R will all be selected for publishing along with the currently selected Note A.
|
|
||||||
|
|
||||||
Each time you click the "Add linked" button, the Publish plugin will look for links within every currently selected file to include for publication. Please be sure you review the list of selected files before clicking the "Publish" button.
|
|
||||||
|
|
||||||
### Delete published notes
|
|
||||||
|
|
||||||
You always have the option of removing any notes that have been published to your site. Within the Publish plugin, all published notes will be listed, of which any/all can be selected for removal. Deleting a note from your site **does not** remove the note from your vault, thus giving you the option to re-publish the note again in the future.
|
|
||||||
|
|
||||||
### Delete entire site
|
|
||||||
|
|
||||||
If you'd like to delete an entire site, click the switch-site (arrows) icon near the top of the Publish plugin. Then click the X button to delete your site. Note: this only removes your public site but does not affect any files in your vault. You can always choose to re-publish your notes.
|
|
@ -1,8 +0,0 @@
|
|||||||
The Quick switcher lets you jump to other notes without leaving your keyboard. The shortcut to invoke it is `Ctrl/Cmd+O`. Just start typing, and matching filenames will be selected. Use up and down arrows to navigate the results, `Enter` to jump to a result, and `Esc` to exit the quick switcher. Holding down `Cmd/Ctrl` will cause the note to open in a new pane.
|
|
||||||
|
|
||||||
If you want to create a new note, typing a unique name will cause the Quick Switcher to create it. If the name is similar enough to an existing note, the Quick Switcher will default to opening the original note. To avoid this, holding down `shift` will force creation of a new note with whatever name is in the Quick Switcher. This can be combined with `Cmd/Ctrl` to create the new note in a new pane.
|
|
||||||
|
|
||||||
![[Pasted image 11.png]]
|
|
||||||
|
|
||||||
Before you enter anything, the top 5 most recently visited notes will be shown, so it's also useful to quickly switch two notes by doing `Ctrl/Cmd+O` → `Down arrow` → `Enter`.
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
|||||||
Random note does just that, opens a note at random from your Vault. Many people find this useful for surfacing thoughts they had not considered in a long time, or spot checking for things that they may have forgotten to link.
|
|
||||||
|
|
||||||
After you enable the Random Note plugin, you can create a [[Custom hotkeys|custom hotkey]] that opens a note at random.
|
|
@ -1,82 +0,0 @@
|
|||||||
![[Search.png]]
|
|
||||||
|
|
||||||
Search is a powerful feature, and has the potential to be confusing. In most cases, if you just type what you want to find, it will work. But search has many capabilities for narrowing down to find exactly what you want.
|
|
||||||
|
|
||||||
## Quick tips
|
|
||||||
|
|
||||||
### Start searching
|
|
||||||
|
|
||||||
You can invoke search by pressing `Ctrl-Shift-F` or `Cmd-Shift-F`. You can also customize this hotkey in Settings => Hotkeys. When search is invoked, focus will be automatically put in the search bar so you can start typing your query right away.
|
|
||||||
|
|
||||||
### Search selected text
|
|
||||||
|
|
||||||
After you select text, you can search for it by simply invoking search like above.
|
|
||||||
|
|
||||||
## Search history
|
|
||||||
|
|
||||||
Obsidian will remember your most recently used search queries.
|
|
||||||
|
|
||||||
These queries will be presented to you when your search query is empty. You can click on any one of them to search for it again, allowing you to easily re-run previous queries.
|
|
||||||
|
|
||||||
To clear search history, simply click on the "X" button.
|
|
||||||
|
|
||||||
## Search Settings
|
|
||||||
|
|
||||||
There are a couple of toggles available while searching:
|
|
||||||
|
|
||||||
- `Match case` toggle case sensitive matching, but note that it can be overridden on a per-search basis using the `match-case:` and `ignore-case:` operators explained above.
|
|
||||||
- `Explain search term` will show you what the search query actually does in plain terms.
|
|
||||||
- `Collapse results` will toggle between just showing matching note names and showing the lines in which matches appear. These extended results can be toggled for each note by clicking on the folding triangle next to the file name.
|
|
||||||
- `Show more context` will expand the display of the matches to show more text around the match.
|
|
||||||
- `Change sort order` sorts the results by various orders, similar to how files are sorted in the [[File explorer]].
|
|
||||||
|
|
||||||
## Copy search results
|
|
||||||
|
|
||||||
To quickly and easily take your search results to a list, use the "copy search result" option.
|
|
||||||
|
|
||||||
You can customize whether you want to show paths, which link style to use (wikilink or Markdown link), and how you want your list to appear.
|
|
||||||
|
|
||||||
## Embed search results
|
|
||||||
|
|
||||||
You can embed search results in a note.
|
|
||||||
|
|
||||||
For example, if you write:
|
|
||||||
|
|
||||||
<pre><code>```query
|
|
||||||
embed OR search
|
|
||||||
```</code></pre>
|
|
||||||
|
|
||||||
You should see this embedded search view (note: it doesn't work on [[Obsidian Publish]] as of 2020/01/18):
|
|
||||||
|
|
||||||
```query
|
|
||||||
embed OR search
|
|
||||||
```
|
|
||||||
|
|
||||||
## Search syntax
|
|
||||||
|
|
||||||
### Combining sub-queries
|
|
||||||
|
|
||||||
When crafting a search query, remember that clicking "Explain Search Term" will give an explanation of what is being searched for, which can be very useful when debugging a complicated search.
|
|
||||||
|
|
||||||
- Words in the search query separated by space will be searched independently in each note. For example `foo bar` will find a note that includes both `foo` and `bar` anywhere in it.
|
|
||||||
- `"Quoted strings"` can be used to search multiple consecutive words separated by space, or in other words, a phrase. So, searching for `"foo bar"` with quotes will only find notes that include those words next to each other. You can use backslash `\"` to escape double quotes if you actually want to search for a string that includes quotes. And `\\` will do the same for backslash.
|
|
||||||
- Boolean operations can be used. Use `OR` to match one or another. Use `-` to negate a query. The space character is used for boolean "and".
|
|
||||||
- For example: `foo OR bar` will find all notes that contain either of those words, they don't have to be in the same note. `foo -bar` will find all notes that contain `foo`, but not if they also contain `bar`.
|
|
||||||
- Parenthesis can be used to group boolean operations. For example `((a OR b) (c OR d))`. This can be useful when crafting complex searches to make sure things happen in the order you want.
|
|
||||||
- Regular expressions (regex) can now be used in search. Use forward slash to denote a regular expression. For example: `/[a-z]{3}/`. Obsidian accepts the JavaScript flavor regular expressions. You can learn more about it [here](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions).
|
|
||||||
|
|
||||||
### Search operators
|
|
||||||
|
|
||||||
Several special operators are available. Some operators allow nesting queries using parenthesis, for example: `file:("to be" OR -"2B")`. You can use `-` to exclude specific results from search, for example: `foo -tag:#bar`.
|
|
||||||
|
|
||||||
- `file:(...)` will perform the following subquery on the file name. For example: `file:.jpg`. If you use Zettelkasten-style UIDs, this can be useful for narrowing a time range, for example `file:202007`for files created in July of 2020.
|
|
||||||
- `path:(...)` will perform the following subquery on the file path, absolute from the root. For example: `path:"Daily Notes/2020-07"`.
|
|
||||||
- `content:(...)` will perform the following subquery on the file content. For example: `content:"happy cat"`.
|
|
||||||
- `match-case:(...)` and `ignore-case(...):` will override the case sensitive match logic for the following subquery.
|
|
||||||
- `tag:` will search for your specified tag within a file, for example `tag:#work`. This is faster and more accurate than searching for the tag in plaintext `#work`, as it uses the cached information and ignores text in code blocks and sections that aren't markdown text.
|
|
||||||
- `line:(...)` will perform the subquery on a line-by-line basis, rather than a file-by-file basis. For example, if you search for `foo bar`, this could match a file that has `foo` in the first paragraph and `bar` in the last paragraph. Searching for `line:(foo bar)` will only match if `foo` and `bar` are on the same line.
|
|
||||||
- `block:(...)` will perform the subquery on a block-by-block basis, where each block defined as a markdown block, typically separated by empty lines or list items. This is expensive computationally as it requires parsing each file, which means this is likely slower than other modes.
|
|
||||||
- `section:(...)` will perform the subquery on a section-by-section basis, where each section is the text between two headings, including the first heading.
|
|
||||||
- `task:(...)` will perform the subquery only on each [[Format your notes#Task list|task]] and on a block-by-block basis. Use `task:""` to match all tasks.
|
|
||||||
- `task-todo:(...)` will perform the subquery only on each *uncompleted* [[Format your notes#Task list|task]] and on a block-by-block basis. Use `task-todo:""` to match all uncompleted tasks.
|
|
||||||
- `task-done:(...)` will perform the subquery only on each *completed* [[Format your notes#Task list|task]] and on a block-by-block basis. Use `task-done:""` to match all completed tasks.
|
|
@ -1,13 +0,0 @@
|
|||||||
Slides lets you do simple presentations right inside Obsidian.
|
|
||||||
|
|
||||||
### Usage tips
|
|
||||||
|
|
||||||
1. To separate slides, use newlines and the `---` separator.
|
|
||||||
|
|
||||||
2. To start a presentation, click this button after opening a note:
|
|
||||||
|
|
||||||
![[Pasted image 14.png]]
|
|
||||||
|
|
||||||
### Demo
|
|
||||||
|
|
||||||
Check out the demo document: [[Slides demo]]
|
|
@ -1,5 +0,0 @@
|
|||||||
Starred notes are a convenient way of keeping important notes close at hand. Enabling the plugin will create a star icon on the left panel, which brings up a list of starred notes.
|
|
||||||
|
|
||||||
To star a file, you have several options. You can do so from a right click in the file explorer, a click on the options menu of an open note, typing in the [[command palette]], or a hotkey that can be set in [[Use hotkeys]].
|
|
||||||
|
|
||||||
Starred files and searches can be reordered by dragging them around.
|
|
@ -1,27 +0,0 @@
|
|||||||
Adds a panel on the right that displays all the tags you have, along with their tag count.
|
|
||||||
|
|
||||||
When clicking on a tag, a search for the tag is activated. To ==toggle a tag== in search, Ctrl-click it instead.
|
|
||||||
|
|
||||||
### Sorting
|
|
||||||
|
|
||||||
The tags are sorted from most frequently used to least frequently used. You can change the sort order to alphabetical or reverse it.
|
|
||||||
|
|
||||||
### Nested tags
|
|
||||||
|
|
||||||
If you write your tags like `#inbox/to-read` and `#inbox/processing`, you can enable "show nested tags" to view them as a tree instead of a flat list.
|
|
||||||
|
|
||||||
Under the default flat view, the tag pane will look like:
|
|
||||||
|
|
||||||
```
|
|
||||||
- inbox/to-read
|
|
||||||
- inbox/processing
|
|
||||||
```
|
|
||||||
|
|
||||||
Under the nested tag view, the tag pane will look like:
|
|
||||||
|
|
||||||
```
|
|
||||||
- inbox
|
|
||||||
- to-read
|
|
||||||
- processing
|
|
||||||
```
|
|
||||||
|
|
@ -1,37 +0,0 @@
|
|||||||
The Templates plugin lets you quickly insert snippets of text into your current note.
|
|
||||||
|
|
||||||
### Set up template folder
|
|
||||||
|
|
||||||
Each template snippet is just a normal Markdown note, like everything else in Obsidian.
|
|
||||||
|
|
||||||
To designate template files, put them into a folder, and choose that folder in Settings => Templates => "Template folder location" after enabling the plugin
|
|
||||||
|
|
||||||
### Insert a template
|
|
||||||
|
|
||||||
After setting up the folder location, using the ribbon icon to insert the template. As always, you can also set a hotkey for this option, or use the command palette to access it.
|
|
||||||
|
|
||||||
The template snippet will be inserted in the current caret position, with special text replaced by their actual value at the time of the insertion (see below).
|
|
||||||
|
|
||||||
### Insert title
|
|
||||||
|
|
||||||
If you want to insert the title of a note, you can set it in a template with `{{title}}`.
|
|
||||||
|
|
||||||
### Insert date and time
|
|
||||||
|
|
||||||
In the plugin settings of Template, you can also set a date format and a time format.
|
|
||||||
|
|
||||||
After setting these formats, `{{date}}` and `{{time}}` in the template files will be replaced by the formatting current time.
|
|
||||||
|
|
||||||
For formatting syntax documentation, [please see here](https://momentjs.com/docs/#/displaying/format/).
|
|
||||||
|
|
||||||
_Tip: if you want to have two date formats or two time formats, you can use the other `{{time}}` as the second `{{date}}`, or `{{date}}` as the second `{{time}}`._
|
|
||||||
|
|
||||||
### One-off date formats
|
|
||||||
|
|
||||||
In addition to `{{date}}` and `{{time}}`, which will work in all template files, you can also write `{{date:YYYY-MM-DD}}` to insert a date with a certain format just once. This will override the `{{date}}` format. Anything after `:` will be considered part of the date format.
|
|
||||||
|
|
||||||
`{{time:HH:mm}}` works similarly.
|
|
||||||
|
|
||||||
### Using custom date formats elsewhere
|
|
||||||
|
|
||||||
Currently, dates like `{{date:YYYY-MM-DD}}` and `{{time:HH:mm}}` also work in the template file of the [[Daily notes]] and [[Zettelkasten prefixer]] plugins. However, `{{date}}` and `{{time}}` do not work yet.
|
|
@ -1,3 +0,0 @@
|
|||||||
Word count is a simple plugin that shows the word count of your current note in the bottom status bar.
|
|
||||||
|
|
||||||
It works for CJK characters too (Chinese, Japanese, and Korean), in which words are not separately by spaces but rather glued together.
|
|
@ -1,19 +0,0 @@
|
|||||||
|
|
||||||
The Workspaces plugin lets you save and load "workspaces". Each workspace includes pane layout, sidebar state (expanded or collapsed), and file open states.
|
|
||||||
|
|
||||||
![[Pasted image 19.png]]
|
|
||||||
|
|
||||||
### Save a workspace
|
|
||||||
|
|
||||||
Either click on the workspace icon in the ribbon to open "Manage workspaces".
|
|
||||||
|
|
||||||
Give the current layout a new name, click on "Save", and it will appear in the list below.
|
|
||||||
|
|
||||||
### Load a workspace
|
|
||||||
|
|
||||||
To load or restore a workspace, either open "Manage workspaces" and click on the "Load" button next to the workspace you wish to load, or use the "Load workspaces" command to bring up a command-palette-like interface to search and choose workspaces.
|
|
||||||
|
|
||||||
|
|
||||||
### Commands
|
|
||||||
|
|
||||||
This plugin has two commands that you can access through [[Command palette]]: manage workspaces and load workspaces. You can also define hotkeys for them.
|
|
@ -1,8 +0,0 @@
|
|||||||
Adds a new button to the left pane, which can be used to create a new file and prefix it for you using the current time. This can be beneficial if you are a follower of the Zettelkasten UID-in-filename method.
|
|
||||||
|
|
||||||
The default format is 12-digit timestamp, e.g. "202001010000".
|
|
||||||
|
|
||||||
### Templates
|
|
||||||
You can define a [[Templates|template file]] for your Zettelkasten notes. This file will be copied when a new Zettel note is created.
|
|
||||||
|
|
||||||
For the Zettelkasten prefixer plugin, `{{date}}` and `{{time}}` do not work. Please use `{{date:YYYY-MM-DD}}` and `{{time:HH:mm}}` in your template.
|
|
@ -1,43 +0,0 @@
|
|||||||
Hi there! I'm a note in your vault.
|
|
||||||
|
|
||||||
At the same time, I'm also just a Markdown file sitting on your hard disk. It's all in plain text, so you don't need to worry about losing me in case [[Obsidian]] disappears one day.
|
|
||||||
|
|
||||||
## Quick Start
|
|
||||||
|
|
||||||
If you're in a hurry, here's some quick places to dive in:
|
|
||||||
|
|
||||||
- The [[Command palette]] contains most of the commands you need to work with Obsidian. Just press `Ctrl/Cmd-P` and start typing.
|
|
||||||
- How to [[Create notes|create new notes]].
|
|
||||||
- How to create [[Internal link|internal links]]
|
|
||||||
- How to use Markdown to [[Format your notes]]
|
|
||||||
- How to [[embed files]], or embed other notes
|
|
||||||
- [[Use hotkeys]]
|
|
||||||
- How to [[Working with multiple notes|open multiple files side by side]]
|
|
||||||
- Obsidian can be extended with [[Core plugins|plugins]]. Several are available by default, and can be enabled or disabled according to your needs.
|
|
||||||
|
|
||||||
|
|
||||||
If you want a more thorough introduction, including a bit about our philosophy, check out [[Obsidian]].
|
|
||||||
|
|
||||||
And if you'd like a gentle introduction, or just want to get started but don't know how, head over to [[Basic note taking]].
|
|
||||||
|
|
||||||
If you are a [Catalyst supporter](https://obsidian.md/pricing), and want to turn on Insider Builds, see [[Insider builds]].
|
|
||||||
|
|
||||||
## Workflows
|
|
||||||
|
|
||||||
Obsidian is a tool that can be used in many ways, from a simple list of notes to a very powerful knowledge management system. We suggest you start at your own pace, and build it into the tool you need.
|
|
||||||
|
|
||||||
Here are a few ways to get started:
|
|
||||||
|
|
||||||
If you want to just start taking notes, check out [[Basic note taking]]
|
|
||||||
|
|
||||||
If you already have a collection of notes in markdown format, just choose them for your Vault. Choose "Vault" in the lower left and select the directory your notes are in.
|
|
||||||
|
|
||||||
If you have notes from Roam Research, Notion, or other systems, [[Import data|here's how to import them]].
|
|
||||||
|
|
||||||
If you'd like to know more about Obsidian, you can [[Obsidian|read about our story]].
|
|
||||||
|
|
||||||
By the way, you can feel free to edit these help docs, but when you open it again, they will be overwritten. So, don't put anything in them you want to keep.
|
|
||||||
|
|
||||||
## I have questions.
|
|
||||||
|
|
||||||
Then you should join our [community!](https://obsidian.md/community). We have active Discord and Forums, and the community is generally quite helpful.
|
|
@ -1,23 +0,0 @@
|
|||||||
Vault switcher lets you switching between existing vaults and create new vaults.
|
|
||||||
|
|
||||||
## Open vault switcher
|
|
||||||
|
|
||||||
To open the vault switcher, click on the vault icon at the bottom group of the [[Ribbon]] actions. The tooltip text should say “Open another vault”.
|
|
||||||
|
|
||||||
You can see the [[#current vault list]] and [[#create new vaults]] here. Because this is the first screen new users see, it also displays name of the program and the [[current version]], along with a dropdown to switch [[Interface language]].
|
|
||||||
|
|
||||||
## Current vault list
|
|
||||||
|
|
||||||
On the left side of the vault switcher, you can see all the vaults you have accessed before on this device. For each vault, you can see the name of that vault (which is the name of the vault folder), and the path to that folder.
|
|
||||||
|
|
||||||
Clicking on a vault in this list will open that vault. The cross icon lets you delete the vault from this list.
|
|
||||||
|
|
||||||
> Note: deleting a vault from this list **will not delete the vault folder from your device**. It will be “forgotten” and removed from the list.
|
|
||||||
|
|
||||||
## Create new vaults
|
|
||||||
|
|
||||||
Vaults can be created in two ways:
|
|
||||||
|
|
||||||
1. Choose “Create new vault” and enter the name of the vault along with where it will be stored. Essentially Obsidian creates an empty folder in that location and open it as a vault for you;
|
|
||||||
2. Choose “Open folder as vault” and select a folder on your device. This is the recommended method if you already have a backup or exported folder of Markdown files.
|
|
||||||
|
|
@ -1,7 +0,0 @@
|
|||||||
Panes can be linked together. This has two main effects:
|
|
||||||
|
|
||||||
- By default, when opening a new [[Preview and edit modes|preview pane]] from an editing pane, the new pane is linked to the old one. This means that any changes you make in the editor will show up in the preview in real time. It also means that scrolling one will scroll the other.
|
|
||||||
|
|
||||||
- When a new [[Working with backlinks|Backlink Pane]] is created from a note, it will be linked to that note. This means that [[backlinks]] will always be shown for the note that is in that pane. This is useful if you want to reference a set of [[backlinks]] but let the regular backlink panel change with whatever other note you are working on.
|
|
||||||
|
|
||||||
Linked panes will be marked with a link icon. You can hover the link to see which pane it's linked to, or click the icon to release it, so that they are no longer linked. This will not close the previously-linked pane.
|
|
@ -1,52 +0,0 @@
|
|||||||
One of the things that makes [[Obsidian]] different from other note-taking apps is how easy it is to open multiple files in your preferred configuration.
|
|
||||||
|
|
||||||
The window a file gets opened in is what we call a "pane". You can have as many panes as you like.
|
|
||||||
|
|
||||||
### Open new panes
|
|
||||||
|
|
||||||
#### Open links
|
|
||||||
|
|
||||||
In general, you can click a link to a file while holding Ctrl (on Windows and Linux) or Cmd (on macOS) to open it in a new pane. This includes clicking on files in [[File explorer]], [[Search]] results, [[Backlinks]], [[Graph view]], etc.
|
|
||||||
|
|
||||||
The only notable exception is in the editor. Because in the editor, a single click edits the link text rather than following it, `Ctrl/Cmd-Click` is used to follow the link. Therefore, you'll need to hold Shift in addition to Ctrl/Cmd in order to open the link in a new pane.
|
|
||||||
|
|
||||||
#### Split current pane
|
|
||||||
|
|
||||||
You can also use the "More options" menu option of a pane to select "Split vertically" or "Split horizontally" to open two copies of that file.
|
|
||||||
|
|
||||||
#### Open linked views
|
|
||||||
|
|
||||||
Some options in the "More options" menu will also open a new pane that's linked to the current pane, such as "Open backlinks" and "Open local graph".
|
|
||||||
|
|
||||||
### Rearrange panes
|
|
||||||
|
|
||||||
To move a pane, simply drag the pane icon in the top left corner of the pane. As you drag it around, a visual indicator will appear to show where the pane will be placed. Dropping onto each of the four sides of an existing pane creates a horizontal or vertical split, and dropping in the center swaps positions with the target pane.
|
|
||||||
|
|
||||||
You can also drag panes into the two sidebars. Panes in the sidebar work a bit differently, for more please see the [[#Panes in the sidebar]] section below.
|
|
||||||
|
|
||||||
### Panes in the sidebar
|
|
||||||
|
|
||||||
There are some differences with panes that live in the [[Sidebar|sidebars]].
|
|
||||||
|
|
||||||
#### Sidebar panes can share space with tabs
|
|
||||||
|
|
||||||
When your drop a pane onto a sidebar pane, a new tab will be created under that sidebar section. Different panes in the same sidebar section can be accessed by clicking on its tab icon.
|
|
||||||
|
|
||||||
#### Sidebar panes do not show titles
|
|
||||||
|
|
||||||
This reduces clutter, but also means it's best to keep one or two important files like a scratch pad or the daily note for quick access, rather than having a dozen files open.
|
|
||||||
|
|
||||||
To see the title of a file that's in the sidebar, hover over its tab icon.
|
|
||||||
|
|
||||||
#### Sidebar can be easily collapsed
|
|
||||||
|
|
||||||
If there are panes that you only need to look at from time to time, having them in the sidebar makes it really easy to toggle them with a hotkey or command.
|
|
||||||
|
|
||||||
#### Toggle editor and preview in sidebar
|
|
||||||
|
|
||||||
The hotkey to toggle between editor and preview only works in the main workspace. In the sidebar, you'll need to right click on the tab icon and select "Preview" or "Edit" to toggle between two modes.
|
|
||||||
|
|
||||||
### Save and load pane layouts
|
|
||||||
|
|
||||||
The [[Workspaces]] plugin makes it easy to come back to a particular pane layout. Give it a try!
|
|
||||||
|
|
@ -1,13 +0,0 @@
|
|||||||
The ribbon is a space for common commands that occupies the vertical space at the very left of the interface. It’s part of the left [[Sidebar]] and is always visible, even if the left sidebar is closed.
|
|
||||||
|
|
||||||
## Actions
|
|
||||||
|
|
||||||
Each action is presented by an icon in the ribbon. Hovering them will present a tooltip; clicking or tapping them will activate the action.
|
|
||||||
|
|
||||||
The top ones are added by plugins, both [[Core plugins|core plugins]] and [[community plugins]].
|
|
||||||
|
|
||||||
The bottom three actions are Obsidian system actions to:
|
|
||||||
|
|
||||||
1. Open another vault;
|
|
||||||
2. Get help (opens [[help vault]] on the [[desktop app]] and opens [[online help]] in the [[Obsidian Mobile|mobile app]]);
|
|
||||||
3. Open settings.
|
|
@ -1,37 +0,0 @@
|
|||||||
Obsidian has two sidebars on both left and right. The left sidebar includes the [[Ribbon]].
|
|
||||||
|
|
||||||
## Open hidden sidebars
|
|
||||||
|
|
||||||
If a sidebar collapsed, you can open it by clicking on the Arrow icon to expand it.
|
|
||||||
|
|
||||||
This commonly happens when you enable a plugin but cannot find it anywhere–chances are the new pane created by the plugin is hidden in one of the sidebars. So be sure to check there!
|
|
||||||
|
|
||||||
## Tabs
|
|
||||||
|
|
||||||
By default, plugins will only create new tabs instead of new [[#Panes]].
|
|
||||||
|
|
||||||
You can switch between tabs by clicking on the icon. A tooltip will also appear to help you identify tabs.
|
|
||||||
|
|
||||||
In each pane, you can only see one tab at every given moment. Some actions will automatically bring a tab into view, for example when you click on a tag.
|
|
||||||
|
|
||||||
### Close tabs
|
|
||||||
|
|
||||||
Some tabs can be closed via the right click menu, but some cannot be closed. If you don’t want to see it, consider disable the relevant plugin or collapse the sidebar by clicking on the Arrow icon.
|
|
||||||
|
|
||||||
### Rearrange tabs
|
|
||||||
|
|
||||||
As of July 2021, there’s no way to rearrange the tabs. If you’d find this handy, echo your voice in [this feature request](https://forum.obsidian.md/t/reorder-tabs-of-panels-in-left-sidebar/9812).
|
|
||||||
|
|
||||||
## Panes
|
|
||||||
|
|
||||||
You can have multiple panes in the sidebar.
|
|
||||||
|
|
||||||
### Create panes
|
|
||||||
|
|
||||||
To get a new pane, drag the icon of a tab to above or below a current pane. The highlighted area will indicate where the new pane will be created.
|
|
||||||
|
|
||||||
### Close panes
|
|
||||||
|
|
||||||
To close a pane, you can [[#Close tabs|close all tabs in it]], or drag all tabs in it by their icons and drop them into an existing pane.
|
|
||||||
|
|
||||||
When only the tab area of a pane is highlighted, the tab being dragged will be dropped into that pane to merge with other tabs in that pane.
|
|
@ -1,5 +0,0 @@
|
|||||||
The status bar shows handy information. That include helpful information about the current file, the current vault, or the current status like time and date.
|
|
||||||
|
|
||||||
Status items are added both by [[Core plugins|core plugins]] and [[community plugins]].
|
|
||||||
|
|
||||||
Some items are interactive but some are purely informational. For example, the [[Word count]] plugin adds the word and character count that’s not clickable, and the [[Obsidian Sync|Sync plugin]] adds an icon that both shows the sync status as well as shows the sync log upon being clicked.
|
|
@ -1,24 +0,0 @@
|
|||||||
Title bar is the bar at the very top of Obsidian.
|
|
||||||
|
|
||||||
### Window title
|
|
||||||
|
|
||||||
The window title, which is the text at the very center of the title bar, indicates the name of the current vault, as well as the current version number.
|
|
||||||
|
|
||||||
### Navigation
|
|
||||||
|
|
||||||
At the left end of the title bar, there are two arrow buttons that let you go back and forward. Because how common they are used, we recommend using the hotkeys instead.
|
|
||||||
|
|
||||||
### Window management
|
|
||||||
|
|
||||||
At the right end of the title bar, you have the buttons to:
|
|
||||||
|
|
||||||
- Minimize the window;
|
|
||||||
- Maximize the window if it’s not maximized, or restore previous size if maximized;
|
|
||||||
- Close the window.
|
|
||||||
|
|
||||||
|
|
||||||
### Native title bar
|
|
||||||
|
|
||||||
The title bar in Obsidian is custom-built and may not have feature parity with the native title bar that you’re used to on your operating system.
|
|
||||||
|
|
||||||
Currently you can’t disable the custom title bar. If it would be helpful to you, consider echoing your voice in [this feature request](https://forum.obsidian.md/t/add-option-to-enable-disable-frameless-mode/6991).
|
|
@ -1,9 +0,0 @@
|
|||||||
The workspace in [[Obsidian]] contains the follow components:
|
|
||||||
|
|
||||||
- [[Title bar]]
|
|
||||||
- [[Sidebar|Sidebars]]
|
|
||||||
- [[Sidebar#Panes|Sidebar panes]]
|
|
||||||
- [[Sidebar#Tabs|Sidebar tabs]]
|
|
||||||
- [[Ribbon]] (left sidebar only)
|
|
||||||
- [[Pane layout|Panes]]
|
|
||||||
- [[Status bar]]
|
|
@ -1,57 +0,0 @@
|
|||||||
## What is MindStone?
|
|
||||||
MindStone is a free open-source alternative solution to [Obsidian Publish](https://obsidian.md/publish)
|
|
||||||
|
|
||||||
Here how it look like once published:
|
|
||||||
|
|
||||||
![](/images/CleanShot%202022-04-20%20at%2008.34.17@2x.png)
|
|
||||||
|
|
||||||
This website include a published version of default Obsidian Help vault, [[Start here]]
|
|
||||||
|
|
||||||
**MindStone features:**
|
|
||||||
|
|
||||||
- ✅ **Drop-in** support for (default) **Obsidian Vault**
|
|
||||||
- ✅ `[[Wiki Link]]` built-in support
|
|
||||||
- ✅ **Folder-base** navigation side bar
|
|
||||||
- ✅ Backlink support out of the box
|
|
||||||
- ✅ Interactive Graph view
|
|
||||||
- ✅ **Easy to deploy** to Netlify, Vercel...
|
|
||||||
|
|
||||||
## Getting started
|
|
||||||
### Run on your local machine
|
|
||||||
|
|
||||||
Steps to run it on your local machine:
|
|
||||||
1. Clone this [Github repo](https://github.com/TuanManhCao/digital-garden)
|
|
||||||
2. Install [yarn](https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable) package manager
|
|
||||||
3. Copy all of your **markdown** file (`.md` only) and folder to `/posts/` **except** `/posts/index.md` file
|
|
||||||
4. Go to root folder of your project, run `yarn && yarn run dev`
|
|
||||||
5. Open this link in your browser http://localhost:3000/
|
|
||||||
|
|
||||||
If you prefer video content have a look at my 📺 [walk through video](https://youtu.be/7_SmWA-_Wx8)
|
|
||||||
|
|
||||||
### Publish to the internet
|
|
||||||
|
|
||||||
Setup environment (with Netlify)
|
|
||||||
1. Create your Github account and clone [my repository](https://github.com/TuanManhCao/digital-garden)
|
|
||||||
2. Create Netlify account and follow [this instruction](https://www.netlify.com/blog/2020/11/30/how-to-deploy-next.js-sites-to-netlify/)
|
|
||||||
|
|
||||||
|
|
||||||
Your normal workflow for publishing content, after initial setup is:
|
|
||||||
1. Simply writing your content in Obisidian (or your favourite Markdown editor)
|
|
||||||
2. Commit your changes and Push it to your Github repo
|
|
||||||
|
|
||||||
|
|
||||||
If you prefer video content, watch my 📺 [walk through video](https://youtu.be/n8QDO6l64aw) here
|
|
||||||
|
|
||||||
These are just some basic features for MindStone v1, many more are coming (if I find enough of interest and this will probably a premium/paid option):
|
|
||||||
- 🎯 Obsidian, Notion, VSCode Plugin
|
|
||||||
- 🎯 Page Preview (like Obsidian Core plugin)
|
|
||||||
- 🎯 Andy Sliding pane
|
|
||||||
- 🎯 Full text search with `Cmd + K`
|
|
||||||
- 🎯 Infinite canvas for browsing through notes and connections
|
|
||||||
|
|
||||||
### Some know issues
|
|
||||||
This an early version of MindStone, which mean there are bugs and issues. Below are some known issues, that I plan to work on:
|
|
||||||
- Image link in wiki link style is not supported yet. `![[Image_link.png]]` will not work yet. see work around below
|
|
||||||
- Graphview does not load when clicking on side-bar or click node on graphview, browser reload will refresh it state
|
|
||||||
- Graph view layout and interaction is still very rough. More UI/UX improvements are needed.
|
|
||||||
- Transclusion is not working yet.
|
|