|
1 | 1 | # Text Composer for Obsidian |
2 | 2 |
|
3 | | -Text Composer is an Obsidian plugin that compiles a markdown document by recursively including the content of linked documents. This plugin ensures that your main document remains unchanged, while generating a new compiled document. |
| 3 | +## Description |
| 4 | +Text Composer is a powerful Obsidian plugin that allows you to compile multiple markdown documents into a single file. It seamlessly integrates content from linked documents using the `![[link_to_document]]` syntax, preserving the structure and hierarchy of your notes. |
| 5 | + |
| 6 | +## Benefits and Why to Use It |
| 7 | +- **Streamlined Note Compilation**: Easily merge multiple linked documents into one comprehensive markdown file. |
| 8 | +- **Recursive Linking**: Handles nested links efficiently, ensuring all referenced content is included. |
| 9 | +- **Non-Intrusive**: Creates a new compiled document, leaving your original notes unchanged. |
| 10 | +- **Time-Saving**: Automates the process of gathering content from multiple documents, enhancing productivity. |
4 | 11 |
|
5 | 12 | ## Features |
| 13 | +- **Recursive Content Compilation**: Automatically includes content from nested linked documents. |
| 14 | +- **Non-Destructive**: Generates a new markdown file with the compiled content. |
| 15 | +- **User-Friendly Commands**: Easily trigger the compilation process using Obsidian’s command palette. |
| 16 | +- **Customizable Settings**: Configure plugin settings to suit your workflow. |
| 17 | + |
| 18 | +## How to Use It |
| 19 | +1. **Install the Plugin**: |
| 20 | + - Ensure the plugin is installed and enabled in Obsidian. Navigate to **Settings** → **Community plugins** → **Text Composer** and enable it. |
| 21 | + |
| 22 | +2. **Prepare Your Documents**: |
| 23 | + - Create a main markdown document with links to other documents using the `![[link_to_document]]` syntax. |
| 24 | + |
| 25 | +3. **Compile the Document**: |
| 26 | + - Open the main markdown document in Obsidian. |
| 27 | + - Press `Ctrl + P` (or `Cmd + P` on macOS) to open the command palette. |
| 28 | + - Type `Compile MD Document` and select the command. |
| 29 | + - A new markdown file with the `_compiled.md` suffix will be created, containing the compiled content. |
| 30 | + |
| 31 | +4. **Example**: |
| 32 | + - **Main Document (`main_document.md`)**: |
| 33 | + ```markdown |
| 34 | + # Main Document |
| 35 | + Lorem ipsum... |
| 36 | + ![[nested_document_a]] |
| 37 | + ...dolor sit amet... |
| 38 | + ![[nested_document_b]] |
| 39 | + ...the end of the document. |
| 40 | + ``` |
| 41 | + - **Nested Document A (`nested_document_a.md`)**: |
| 42 | + ```markdown |
| 43 | + ## Nested Document A |
| 44 | + Content from nested document A. |
| 45 | + ``` |
| 46 | + - **Nested Document B (`nested_document_b.md`)**: |
| 47 | + ```markdown |
| 48 | + ## Nested Document B |
| 49 | + Content from nested document B. |
| 50 | + ``` |
| 51 | + |
| 52 | + - After running the "Compile MD Document" command, a new file `main_document_compiled.md` will be created with the merged content. |
6 | 53 |
|
7 | | -- Compile `.md` documents by merging content from linked documents. |
8 | | -- Recursively handle nested document links. |
9 | | -- Generate a new `.md` file with the compiled content, leaving the original document unchanged. |
| 54 | +## Conclusion |
| 55 | +Text Composer for Obsidian is a must-have tool for users who need to consolidate their notes into a single document efficiently. By automating the integration of linked documents, it saves time and enhances productivity, making it an essential plugin for your Obsidian workflow. |
0 commit comments