Skip to content

Commit 0bb4ba1

Browse files
FilipFilip
authored andcommitted
update readme.me
1 parent 09dbf97 commit 0bb4ba1

File tree

1 file changed

+50
-4
lines changed

1 file changed

+50
-4
lines changed

README.md

Lines changed: 50 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,55 @@
11
# Text Composer for Obsidian
22

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.
411

512
## 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.
653

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

Comments
 (0)