Git Product home page Git Product logo

markdown-note-rafactor's Introduction

Markdown Note Refactor for VS Code

Markdown Note Refactor is a Visual Studio Code extension that aims to streamline the process of managing and organizing markdown files. This tool allows users to automatically split sections of a markdown file into separate files based on h2 headers and link them together for easy navigation. Inspired by the Obsidian community plugin note-refactor-obsidian, this extension brings similar functionality to VS Code, enhancing productivity for writers, developers, and note-takers working with markdown files.

Features

  • Automated Section Splitting: Splits the currently opened markdown file into sections based on h2 headers, each becoming its own separate file.
  • Dynamic File Generation: Automatically generates new markdown files using the h2 header titles as filenames, placed in a specified directory.
  • Content Duplication: Copies the text within the original file's sections into the corresponding new markdown files.
  • Link Creation: Inserts wiki-style links in the original file that point to the newly created files, facilitating easy navigation between them.

Getting Started

Prerequisites

Ensure you have the following installed before you start using Markdown Note Refactor:

  • Visual Studio Code

Installation

To install Markdown Note Refactor:

From the VS Code Extensions Marketplace

  1. Open Visual Studio Code.
  2. Go to the Extensions view by clicking on the square icon on the sidebar or pressing Ctrl+Shift+X.
  3. Search for "Markdown Note Refactor" and click on the install button.

From a VSIX File

  1. Clone or download this repository.
  2. In Visual Studio Code, open the Extensions view (Ctrl+Shift+X).
  3. Click on the ... menu at the top-right corner and select Install from VSIX....
  4. Locate and select the .vsix file that you downloaded or built.

Usage

To use Markdown Note Refactor:

  1. Open the markdown file you wish to refactor in VS Code.
  2. Press Ctrl+Shift+P to open the Command Palette.
  3. Type Markdown Note Refactor: Refactor and Link Sections and press Enter.

The extension will then process the current file, creating new markdown files for each h2 section and updating the original file with links to these new documents.

Contributing

Your contributions make the open-source community a fantastic place for growth, inspiration, and creativity. If you have suggestions for improving Markdown Note Refactor, please fork the repo, create a pull request, or open an issue with the tag "enhancement". Contributions of all kinds are welcome!

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Special thanks to note-refactor-obsidian for the inspiration behind this extension.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.