Hey, I am currently open to new work opportunities, you can find my resume here

• What is this?
• Features
• Examples
• Requirements
• Installation
• Installing package using npm globally
• Multiple instances
• Configuration
• Contributing
• License

Ghore is an open-source, offline command-line interface (CLI) tool specifically designed for developers and writers working with GitHub. Its primary function is to render Markdown files into HTML, closely emulating the GitHub Markdown style. This enables users to preview how their Markdown documents will look on GitHub before committing them to a repository.

• Offline Conversion: Convert Markdown files to HTML offline without the need for an internet connection.
• Watch for Changes: Automatically update the HTML output when changes are made to the input Markdown file.
• GitHub Styling: HTML output mirrors the GitHub Markdown style for consistency.
• Code Block Highlighting: Integrated Starry Night ensures beautiful and syntax-highlighted code blocks.
• Flowchart Support: Live preview of mermaid code blocks (GitHub's API doesn't process mermaid code blocks).
• Auto-open Browser: Automatically opens the preview in your default browser when the server starts.
• Multiple Instances: Run several previews at once — each instance gets its own port automatically selected from the range 5169–5200.
• Instance Tracking: Active instances are logged to a shared file in a temporary directory, showing which file is served at which URL.

Highlights the below code block function using integrated Starry Night

    ```sh
    // Highlight code blocks function
const highlightCode = async (lang, str) => {
  if (!starryNight || !toHtml) {
    await initializeStarryNight();
  }
    ```

const highlightCode = async (lang, str) => {
  if (!starryNight || !toHtml) {
    await initializeStarryNight();
  }

Below mermaid block will be displayed

```mermaid
gitGraph:
    commit "test"
    branch newbranch
    checkout newbranch
    commit id:"1111"
    commit tag:"test"
    checkout main
    commit type: HIGHLIGHT
    commit
    merge newbranch
    commit
    branch b2
    commit
```

gitGraph:
    commit "changes"
    branch newbranch
    checkout newbranch
    commit id:"1111"
    commit tag:"test"
    checkout main
    commit type: HIGHLIGHT
    commit
    merge newbranch
    commit
    branch b2
    commit

Node.js 18.0.0 or above.

# Clone the repository
git clone https://github.com/p-balu/ghore.git

# Navigate to the project directory
cd ghore

# Install dependencies
npm install

# Start the application locally
npm start your/filepath/README.md

Install the package globally

npm i ghore -g

If you are already inside the directory where README.md exists, run:

ghore preview

ghore preview /path/to/your/README.md

The preview opens automatically in your default browser.

You can run multiple previews at the same time. Each instance picks a free port in the range 5169–5200 automatically:

ghore preview README.md &
ghore preview INSTALL.md &
ghore preview docs/CHANGELOG.md &

Each instance logs itself to a shared tracking file inside a temporary directory (printed on startup):

Instance list: /tmp/ghore-abc123/instances

The file format is:

PATH; FILE; URL
/home/user; README.md; http://localhost:5169/
/home/user; INSTALL.md; http://localhost:5170/
/home/user/docs; CHANGELOG.md; http://localhost:5171/

When an instance is stopped (Ctrl+C or SIGTERM), its line is removed automatically.

You can customize the appearance of the HTML output by modifying the included CSS file (styles.css).

Contributions are welcome! Feel free to open issues, submit pull requests, or provide feedback.

This project is licensed under the MIT License.