86 lines
2.4 KiB
Markdown
86 lines
2.4 KiB
Markdown
mdq - Markdown Query
|
|
|
|
`mdq` is a command-line tool for searching, filtering, and highlighting content within Markdown files. It allows you to query markdown documents for specific terms and returns results with context, including headings and list items.
|
|
|
|
Features
|
|
|
|
- Search for keywords: Easily search for specific keywords within markdown files.
|
|
- Highlight results: Search results are highlighted for better visibility using ANSI color codes.
|
|
- Contextual results: Display surrounding context around matches, such as parent headings or list items.
|
|
- Support for multiple search terms: Search for more than one term at once.
|
|
|
|
Usage
|
|
|
|
Once installed, you can use the `mdq` command to search through markdown files. You can pass one or more search terms, and the results will include the matched content with context.
|
|
|
|
Basic Search
|
|
|
|
```bash
|
|
mdq "search term" --file /path/to/your/markdown/files/*.md
|
|
```
|
|
|
|
This will search for the term `"search term"` in all `.md` files in the specified directory.
|
|
|
|
Multiple Search Terms
|
|
|
|
```bash
|
|
mdq "term1" "term2" --file /path/to/your/markdown/files/*.md
|
|
```
|
|
|
|
This will search for both `"term1"` and `"term2"` in the specified markdown files and show the results for both.
|
|
|
|
Search with Context
|
|
|
|
By default, the results will show the keyword matches with surrounding context (headings and list items). You can adjust the context size and highlighting options through various flags.
|
|
|
|
|
|
Example
|
|
|
|
If you have a Markdown file like this:
|
|
|
|
```markdown
|
|
# Tasks
|
|
|
|
## Deployment
|
|
|
|
- Set up the production environment
|
|
- Set up the staging environment
|
|
|
|
## Testing
|
|
|
|
- Test the production system
|
|
- Test the staging system
|
|
```
|
|
|
|
Running the following command:
|
|
|
|
```bash
|
|
mdq "production" /path/to/your/file.md
|
|
```
|
|
|
|
Will output something like:
|
|
|
|
```markdown
|
|
## Deployment
|
|
- Set up the **production** environment
|
|
- Set up the staging environment
|
|
```
|
|
|
|
Contributing
|
|
|
|
Feel free to fork the repository, open issues, and submit pull requests. If you'd like to contribute to the development of `mdq`, please follow these steps:
|
|
|
|
1. Fork the repository
|
|
2. Create a new branch
|
|
3. Make your changes
|
|
4. Open a pull request
|
|
|
|
Code of Conduct
|
|
|
|
We expect all contributors to follow the project's code of conduct. Please be respectful and considerate when participating in discussions and submitting contributions.
|
|
|
|
License
|
|
|
|
`mdq` is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.
|
|
|