From f09100b5d4ef28f55585358010464536f4394c73 Mon Sep 17 00:00:00 2001 From: Tuan Cao Date: Wed, 16 Mar 2022 12:01:46 +0700 Subject: [PATCH] Add obsidian help vault notes --- Test Linki.md | 0 .../Advanced topics/Accepted file formats.md | 9 + posts/Advanced topics/Community plugins.md | 41 ++ .../Contributing to Obsidian.md | 49 ++ posts/Advanced topics/Customizing CSS.md | 13 + posts/Advanced topics/Deleting files.md | 8 + posts/Advanced topics/Drag and Drop.md | 29 ++ posts/Advanced topics/HTML sanitization.md | 1 + .../How Obsidian stores data.md | 26 ++ posts/Advanced topics/Insider builds.md | 13 + posts/Advanced topics/Using obsidian URI.md | 126 +++++ posts/Advanced topics/YAML front matter.md | 31 ++ posts/Attachments/Backlinks.png | Bin 0 -> 96976 bytes posts/Attachments/Engelbart.jpg | Bin 0 -> 15219 bytes ...xcerpt from Mother of All Demos (1968).ogg | Bin 0 -> 320148 bytes posts/Attachments/Insert alises.png | Bin 0 -> 9874 bytes posts/Attachments/Insider.png | Bin 0 -> 15086 bytes posts/Attachments/Pasted image 1.png | Bin 0 -> 6993 bytes posts/Attachments/Pasted image 10.png | Bin 0 -> 93094 bytes posts/Attachments/Pasted image 11.png | Bin 0 -> 9442 bytes posts/Attachments/Pasted image 13.png | Bin 0 -> 29434 bytes posts/Attachments/Pasted image 14.png | Bin 0 -> 19505 bytes posts/Attachments/Pasted image 15.png | Bin 0 -> 13281 bytes posts/Attachments/Pasted image 16.png | Bin 0 -> 10252 bytes posts/Attachments/Pasted image 17.png | Bin 0 -> 7107 bytes posts/Attachments/Pasted image 18.png | Bin 0 -> 24519 bytes posts/Attachments/Pasted image 19.png | Bin 0 -> 14286 bytes posts/Attachments/Pasted image 3.png | Bin 0 -> 7473 bytes posts/Attachments/Pasted image 4.png | Bin 0 -> 9483 bytes posts/Attachments/Pasted image 5.png | Bin 0 -> 21984 bytes posts/Attachments/Pasted image 6.png | Bin 0 -> 5244 bytes posts/Attachments/Pasted image 7.png | Bin 0 -> 5907 bytes posts/Attachments/Pasted image 8.png | Bin 0 -> 1397 bytes posts/Attachments/Pasted image 9.png | Bin 0 -> 17126 bytes posts/Attachments/Pasted image.png | Bin 0 -> 8525 bytes posts/Attachments/Search.png | Bin 0 -> 55656 bytes posts/Attachments/Slides demo.md | 39 ++ posts/Attachments/Vault picker.png | Bin 0 -> 47520 bytes posts/Concepts/Current version.md | 3 + posts/Concepts/Installer version.md | 7 + posts/Concepts/Interface language.md | 3 + posts/Customization/Appearance.md | 15 + posts/Customization/Custom hotkeys.md | 13 + posts/How to/Add aliases to note.md | 39 ++ posts/How to/Add custom styles.md | 39 ++ posts/How to/Basic note taking.md | 23 + posts/How to/Capture information.md | 15 + posts/How to/Change settings.md | 4 + posts/How to/Create notes.md | 23 + posts/How to/Embed files.md | 77 +++ posts/How to/Folding.md | 15 + posts/How to/Format your notes.md | 438 ++++++++++++++++++ posts/How to/Import data.md | 52 +++ posts/How to/Internal link.md | 19 + posts/How to/Link to blocks.md | 39 ++ posts/How to/Manage attachments.md | 49 ++ posts/How to/Preview and edit modes.md | 5 + posts/How to/Rename notes.md | 9 + posts/How to/Update Obsidian.md | 17 + posts/How to/Use hotkeys.md | 5 + posts/How to/Working with backlinks.md | 13 + posts/How to/Working with multiple cursors.md | 3 + posts/How to/Working with multiple notes.md | 53 +++ posts/How to/Working with multiple vaults.md | 19 + posts/How to/Working with tags.md | 22 + .../Catalyst license.md | 47 ++ .../Commercial license.md | 53 +++ .../Obsidian Publish.md | 211 +++++++++ .../Obsidian Sync.md | 176 +++++++ .../Obsidian Unlimited.md | 9 + .../Refund policy.md | 15 + posts/Obsidian/Android app.md | 45 ++ posts/Obsidian/Credits.md | 57 +++ posts/Obsidian/Index.md | 52 +++ posts/Obsidian/Mobile app beta.md | 39 ++ posts/Obsidian/Obsidian Mobile.md | 7 + posts/Obsidian/Obsidian.md | 60 +++ posts/Obsidian/Official website.md | 7 + posts/Obsidian/iOS app.md | 81 ++++ posts/Plugins/Audio recorder.md | 9 + posts/Plugins/Backlinks.md | 9 + posts/Plugins/Command palette.md | 18 + posts/Plugins/Core plugins.md | 33 ++ posts/Plugins/Daily notes.md | 10 + posts/Plugins/File explorer.md | 13 + posts/Plugins/File recovery.md | 42 ++ posts/Plugins/Graph view.md | 70 +++ posts/Plugins/Markdown format converter.md | 15 + posts/Plugins/Note composer.md | 42 ++ posts/Plugins/Open in default app.md | 5 + posts/Plugins/Outgoing links.md | 17 + posts/Plugins/Outline.md | 1 + posts/Plugins/Page preview.md | 5 + posts/Plugins/Publish.md | 93 ++++ posts/Plugins/Quick switcher.md | 8 + posts/Plugins/Random note.md | 3 + posts/Plugins/Search.md | 82 ++++ posts/Plugins/Slides.md | 13 + posts/Plugins/Starred notes.md | 5 + posts/Plugins/Tag pane.md | 27 ++ posts/Plugins/Templates.md | 37 ++ posts/Plugins/Word count.md | 3 + posts/Plugins/Workspaces.md | 19 + posts/Plugins/Zettelkasten prefixer.md | 8 + posts/Start here.md | 43 ++ posts/User interface/Vault switcher.md | 23 + .../Workspace/Panes/Linked pane.md | 7 + .../Workspace/Panes/Pane layout.md | 52 +++ posts/User interface/Workspace/Ribbon.md | 13 + posts/User interface/Workspace/Sidebar.md | 37 ++ posts/User interface/Workspace/Status bar.md | 5 + posts/User interface/Workspace/Title bar.md | 24 + posts/User interface/Workspace/Workspace.md | 9 + 113 files changed, 3063 insertions(+) create mode 100644 Test Linki.md create mode 100644 posts/Advanced topics/Accepted file formats.md create mode 100644 posts/Advanced topics/Community plugins.md create mode 100644 posts/Advanced topics/Contributing to Obsidian.md create mode 100644 posts/Advanced topics/Customizing CSS.md create mode 100644 posts/Advanced topics/Deleting files.md create mode 100644 posts/Advanced topics/Drag and Drop.md create mode 100644 posts/Advanced topics/HTML sanitization.md create mode 100644 posts/Advanced topics/How Obsidian stores data.md create mode 100644 posts/Advanced topics/Insider builds.md create mode 100644 posts/Advanced topics/Using obsidian URI.md create mode 100644 posts/Advanced topics/YAML front matter.md create mode 100644 posts/Attachments/Backlinks.png create mode 100644 posts/Attachments/Engelbart.jpg create mode 100644 posts/Attachments/Excerpt from Mother of All Demos (1968).ogg create mode 100644 posts/Attachments/Insert alises.png create mode 100644 posts/Attachments/Insider.png create mode 100644 posts/Attachments/Pasted image 1.png create mode 100644 posts/Attachments/Pasted image 10.png create mode 100644 posts/Attachments/Pasted image 11.png create mode 100644 posts/Attachments/Pasted image 13.png create mode 100644 posts/Attachments/Pasted image 14.png create mode 100644 posts/Attachments/Pasted image 15.png create mode 100644 posts/Attachments/Pasted image 16.png create mode 100644 posts/Attachments/Pasted image 17.png create mode 100644 posts/Attachments/Pasted image 18.png create mode 100644 posts/Attachments/Pasted image 19.png create mode 100644 posts/Attachments/Pasted image 3.png create mode 100644 posts/Attachments/Pasted image 4.png create mode 100644 posts/Attachments/Pasted image 5.png create mode 100644 posts/Attachments/Pasted image 6.png create mode 100644 posts/Attachments/Pasted image 7.png create mode 100644 posts/Attachments/Pasted image 8.png create mode 100644 posts/Attachments/Pasted image 9.png create mode 100644 posts/Attachments/Pasted image.png create mode 100644 posts/Attachments/Search.png create mode 100644 posts/Attachments/Slides demo.md create mode 100644 posts/Attachments/Vault picker.png create mode 100644 posts/Concepts/Current version.md create mode 100644 posts/Concepts/Installer version.md create mode 100644 posts/Concepts/Interface language.md create mode 100644 posts/Customization/Appearance.md create mode 100644 posts/Customization/Custom hotkeys.md create mode 100644 posts/How to/Add aliases to note.md create mode 100644 posts/How to/Add custom styles.md create mode 100644 posts/How to/Basic note taking.md create mode 100644 posts/How to/Capture information.md create mode 100644 posts/How to/Change settings.md create mode 100644 posts/How to/Create notes.md create mode 100644 posts/How to/Embed files.md create mode 100644 posts/How to/Folding.md create mode 100644 posts/How to/Format your notes.md create mode 100644 posts/How to/Import data.md create mode 100644 posts/How to/Internal link.md create mode 100644 posts/How to/Link to blocks.md create mode 100644 posts/How to/Manage attachments.md create mode 100644 posts/How to/Preview and edit modes.md create mode 100644 posts/How to/Rename notes.md create mode 100644 posts/How to/Update Obsidian.md create mode 100644 posts/How to/Use hotkeys.md create mode 100644 posts/How to/Working with backlinks.md create mode 100644 posts/How to/Working with multiple cursors.md create mode 100644 posts/How to/Working with multiple notes.md create mode 100644 posts/How to/Working with multiple vaults.md create mode 100644 posts/How to/Working with tags.md create mode 100644 posts/Licenses & add-on services/Catalyst license.md create mode 100644 posts/Licenses & add-on services/Commercial license.md create mode 100644 posts/Licenses & add-on services/Obsidian Publish.md create mode 100644 posts/Licenses & add-on services/Obsidian Sync.md create mode 100644 posts/Licenses & add-on services/Obsidian Unlimited.md create mode 100644 posts/Licenses & add-on services/Refund policy.md create mode 100644 posts/Obsidian/Android app.md create mode 100644 posts/Obsidian/Credits.md create mode 100644 posts/Obsidian/Index.md create mode 100644 posts/Obsidian/Mobile app beta.md create mode 100644 posts/Obsidian/Obsidian Mobile.md create mode 100644 posts/Obsidian/Obsidian.md create mode 100644 posts/Obsidian/Official website.md create mode 100644 posts/Obsidian/iOS app.md create mode 100644 posts/Plugins/Audio recorder.md create mode 100644 posts/Plugins/Backlinks.md create mode 100644 posts/Plugins/Command palette.md create mode 100644 posts/Plugins/Core plugins.md create mode 100644 posts/Plugins/Daily notes.md create mode 100644 posts/Plugins/File explorer.md create mode 100644 posts/Plugins/File recovery.md create mode 100644 posts/Plugins/Graph view.md create mode 100644 posts/Plugins/Markdown format converter.md create mode 100644 posts/Plugins/Note composer.md create mode 100644 posts/Plugins/Open in default app.md create mode 100644 posts/Plugins/Outgoing links.md create mode 100644 posts/Plugins/Outline.md create mode 100644 posts/Plugins/Page preview.md create mode 100644 posts/Plugins/Publish.md create mode 100644 posts/Plugins/Quick switcher.md create mode 100644 posts/Plugins/Random note.md create mode 100644 posts/Plugins/Search.md create mode 100644 posts/Plugins/Slides.md create mode 100644 posts/Plugins/Starred notes.md create mode 100644 posts/Plugins/Tag pane.md create mode 100644 posts/Plugins/Templates.md create mode 100644 posts/Plugins/Word count.md create mode 100644 posts/Plugins/Workspaces.md create mode 100644 posts/Plugins/Zettelkasten prefixer.md create mode 100644 posts/Start here.md create mode 100644 posts/User interface/Vault switcher.md create mode 100644 posts/User interface/Workspace/Panes/Linked pane.md create mode 100644 posts/User interface/Workspace/Panes/Pane layout.md create mode 100644 posts/User interface/Workspace/Ribbon.md create mode 100644 posts/User interface/Workspace/Sidebar.md create mode 100644 posts/User interface/Workspace/Status bar.md create mode 100644 posts/User interface/Workspace/Title bar.md create mode 100644 posts/User interface/Workspace/Workspace.md diff --git a/Test Linki.md b/Test Linki.md new file mode 100644 index 0000000..e69de29 diff --git a/posts/Advanced topics/Accepted file formats.md b/posts/Advanced topics/Accepted file formats.md new file mode 100644 index 0000000..8508196 --- /dev/null +++ b/posts/Advanced topics/Accepted file formats.md @@ -0,0 +1,9 @@ +Obsidian recognizes the following file formats right now: + +1. Markdown files: `md`; +2. Image files: `png`, `jpg`, `jpeg`, `gif`, `bmp`, `svg`; +3. Audio files: `mp3`, `webm`, `wav`, `m4a`, `ogg`, `3gp`, `flac`; +4. Video files: `mp4`, `webm`, `ogv`; +5. PDF files: `pdf`. + +All these types of files can be [[Embed files|embedded]] in a note. diff --git a/posts/Advanced topics/Community plugins.md b/posts/Advanced topics/Community plugins.md new file mode 100644 index 0000000..64f5bab --- /dev/null +++ b/posts/Advanced topics/Community plugins.md @@ -0,0 +1,41 @@ +Obsidian allows developers to write community plugins to extend Obsidian's functionality. + +Right now, the plugin API is in alpha status. This means any part of the API could introduce breaking changes in a future release. + +### For developers + +For instructions on creating new plugins, see [our sample plugin](https://github.com/obsidianmd/obsidian-sample-plugin). + +For documentation on the API, check out [our plugin API repo](https://github.com/obsidianmd/obsidian-api). + +After you created your plugin, you can add it to our community plugin marketplace by creating a pull request in [our releases repo](https://github.com/obsidianmd/obsidian-releases). Refer to the sample plugin on how to release updates for your plugin. + +### For users + +#### Safe Mode + +By default, Obsidian has Safe Mode turned on to protect you from potential harm. Under Safe Mode, no community plugin will run. + +Please be aware that community plugins can access files on your computer, connect to the internet, and even install additional programs. To read more about plugin security, [[#Plugin security|see here]]. + +In order to install community plugins, you need to turn off Safe Mode in Settings -> Community plugin -> Safe Mode. + +#### Discover and install community plugins + +After disabling Safe Mode, you can find community plugins created by the community in Settings -> Community plugin -> Community plugins -> Browse. + +On this page, you can browse plugins by popularity, or search for specific plugins. Click on a plugin to see details and instruction from the plugin author. In the details page, you can click "Install" to install a plugin. + +After installing, you can then find the installed plugins under Settings -> Community plugin. They need to be enabled in order to take effect. You can also uninstall them there. + +### Plugin security + +Thanks for trusting Obsidian with your data! It means a lot to us, and we take security very seriously. That includes community plugins too. + +Due to technical reasons with our platform, we're unable to restrict plugins to a specific permission or access level. Since we offer Obsidian for free, currently we're unable to manually review each plugin. + +The good news is that Obsidian has an amazing and passionate community, so we rely on community trust to ensure security of community plugins. + +In general, you should be able to trust most of the popular plugins from the community. We require all community community plugins to be open sourced on GitHub. **If you're working with sensitive data, we recommend you to inspect the plugin code before installing it, so that your security needs are met.** You can find a link to the plugin repository on the plugin detail page. + +If you find any security flaws with community plugins, contact the plugin author by adding an issue on GitHub. If you believe the plugin is malicious, contact us to get the plugin investigated and removed. diff --git a/posts/Advanced topics/Contributing to Obsidian.md b/posts/Advanced topics/Contributing to Obsidian.md new file mode 100644 index 0000000..5ca06df --- /dev/null +++ b/posts/Advanced topics/Contributing to Obsidian.md @@ -0,0 +1,49 @@ +Thanks for the interest in contributing to Obsidian! + +There are three major ways you can contribute: + +### 1. Financial contribution + +#### Commercial license + +If you'd like to use Obsidian for work activities, try to let your work get you a [[Commercial license|commercial license]]. + +#### Add-on services + +If you'd like to make a website from your notes, consider getting [[Obsidian Publish]] if the price works for you. + +If you're interested in an end-to-end encryption syncing solution, we also offer [[Obsidian Sync]]. In addition to end-to-end encryption, Obsidian Sync also comes with version history. + +#### Catalyst + +If you don't need any of the above, you can get a [[Catalyst license]] to support our developer, which also gives you access to [[insider builds]]. + +#### Obsidian Unlimited + +For those very passionate about the project, there's also the Obsidian Unlimited option, which lets you pay as much as you want to support development and help us stay independent. We recommend going for this option after you've purchased the VIP tier of [[Catalyst license]] so that you can enjoy the benefits. + +### 2. Extending Obsidian + +#### CSS themes + +If you're proficient in CSS, another way is to contribute a theme, so that people who don't know CSS can enjoy your work. If you decide to do so, feel free to share it on the #css-themes channel on Discord, or in the Share & Showcase category on our forum. + +If you'd like to add your theme to the community theme list, let us know! (Or we might reach out to you first!) + +#### Plugins + +If you're a JavaScript/TypeScript programmer, you can write [[Community plugins]] for Obsidian, now that our plugin API is in alpha. + +### 3. Translation and proofreading + +#### Translating the interface + +If you know another language (preferably natively), you can help with translating the Obsidian interface into your language. You can do that by submitting a pull request in [our translation GitHub repository](https://github.com/obsidianmd/obsidian-translations) to get it into the next version of the app. + +#### Translating the docs + +We're in the middle of reorganizing and stabilizing the documentation you're reading right now. Once it's in a good shape, you can also help translate it, so that people who don't know English can also easily learn to use Obsidian. + +#### Found a typo? + +If you found a typo or a grammar mistake in these documentation, feel free to submit a pull request in [our documentation repository](https://github.com/obsidianmd/obsidian-docs). diff --git a/posts/Advanced topics/Customizing CSS.md b/posts/Advanced topics/Customizing CSS.md new file mode 100644 index 0000000..0c16adb --- /dev/null +++ b/posts/Advanced topics/Customizing CSS.md @@ -0,0 +1,13 @@ +If you are building or modifying your own css, you can open the developer tools by using `Ctrl+Shift+I` on Windows/Linux or `Cmd+Opt+I` on macOS to get information on the elements you want to customize. + +Changes to themes and snippets will be detected automatically and reapplied. You do not need to restart the app. + +### New to CSS + +If you're new to CSS, our community has put together a quick guide to get comfortable with CSS: + +> [Getting Comfortable with CSS](https://forum.obsidian.md/t/getting-comfortable-with-obsidian-css/133) + +Klaas also put together a helpful index of common CSS snippets that you can feel free to mix and match: + +> [Obsidian CSS Snippets (on GitHub)](https://github.com/Dmitriy-Shulha/obsidian-css-snippets/tree/master/Snippets) \ No newline at end of file diff --git a/posts/Advanced topics/Deleting files.md b/posts/Advanced topics/Deleting files.md new file mode 100644 index 0000000..d2accee --- /dev/null +++ b/posts/Advanced topics/Deleting files.md @@ -0,0 +1,8 @@ +Obsidian has several options for dealing with deleted files, depending on your needs. + +- By default, deleted files are sent to your system trash. Here you can use whatever means your system has for recovering files you've accidentally deleted. +- Deleted files can be sent to a special `.trash` directory in your Vault. This can be useful if you want the ability to recover your Vault files separate from your system trash. +- You can also set obsidian to just delete files without possibility of recovery. + +These options can be found in Settings → Files & Links. + diff --git a/posts/Advanced topics/Drag and Drop.md b/posts/Advanced topics/Drag and Drop.md new file mode 100644 index 0000000..870036d --- /dev/null +++ b/posts/Advanced topics/Drag and Drop.md @@ -0,0 +1,29 @@ +There are many ways to drag and drop things around Obsidian to make the experience smoother: + +### Drag panes + +See [[Working with multiple notes#5 Panes can be rearranged by dragging|dragging panes]] + +### Drag sources + +- You can drag a file, or multiple files from the [[file explorer]]. +- You can drag a file from a [[search]] result. +- You can drag a file from [[backlinks]] or unlinked references. +- You can drag a file from the [[starred notes]]. +- You can drag a file from a link inside the note, in preview mode. + +### Drop destinations + +- You can drop a file on a pane header to open the file there. Hold `Alt` (or `Shift` on MacOS) to drop anywhere on the pane. +- You can drop a file on a folder in the [[file explorer]] to move the file there. +- You can drop a file into an editor to insert it as a link. The generated link also follows your preferences, such as relative paths, or using markdown links. +- You can drop a file on the [[starred notes]] to star it. + +### Dragging from outside Obsidian + +- You can drag any HTML content from the browser into Obsidian to automatically convert them into Markdown +- You can drag and drop any files from your native file explorer to have Obsidian import (make a copy of) those files in your vault's attachment folder and insert them as internal links. Hold `Ctrl` to create `file:///` absolute links to those files instead of importing a copy. + +### Dropping files outside Obsidian + +- This will create an `obsidian://` URL in the external application for the Obsidian note that you dragged. diff --git a/posts/Advanced topics/HTML sanitization.md b/posts/Advanced topics/HTML sanitization.md new file mode 100644 index 0000000..3ea6ce4 --- /dev/null +++ b/posts/Advanced topics/HTML sanitization.md @@ -0,0 +1 @@ +Obsidian sanitizes html for security reasons. Because it runs locally, scripting vulnerabilities are a more serious problem than they would be in a web applications. Accordingly, we are probably a bit more strict than you may be used to, and you may run into issues if you try to do things like embedding `