Skip to content

lonelypx/DocMark

Repository files navigation

DocMark

License: MIT Version

A simple and powerful documentation converter for transforming Markdown files into beautifully formatted HTML documentation.

🌟 Features

  • Easy Conversion: Convert Markdown files to HTML with a single click
  • Live Preview: See your converted documentation in real-time
  • Clean Interface: Minimalist design focused on functionality
  • Export Options: Save your converted HTML documentation locally
  • No Registration Required: Start using immediately without signup
  • Responsive Output: Generated HTML works perfectly on all devices
  • Fast Processing: Quick conversion without compromising quality

🚀 Demo

Check out the live demo at: https://docmark.lonelypx.com/

📖 Table of Contents

🛠 Installation

Option 1: Clone and Run Locally

# Clone the repository
git clone https://github.com/lonelypx/DocMark.git

# Navigate to the project directory
cd DocMark

# Install dependencies (if using Node.js)
npm install

# Start the development server
npm start

Option 2: Use the Web Version

Simply visit https://docmark.lonelypx.com/ to use DocMark online without any installation.

💻 Usage

Basic Usage

  1. Input Your Markdown: Paste or type your Markdown content into the editor
  2. Preview: Use the preview feature to see how your documentation will look
  3. Export: Click "Export HTML" to download your converted documentation

📋 Supported Markdown Features

  • Headers (H1-H6)
  • Text Formatting (bold, italic, strikethrough)
  • Lists (ordered and unordered)
  • Links and Images
  • Code Blocks (with syntax highlighting)
  • Tables
  • Blockquotes
  • Horizontal Rules
  • Line Breaks

🎨 Customization

Themes

DocMark supports multiple themes for your documentation:

  • Default
  • Dark Mode
  • Minimal
  • Corporate

Custom CSS

You can customize the appearance by adding your own CSS:

<style>
/* Your custom styles here */
.docmark-content {
    font-family: 'Your Preferred Font', sans-serif;
}
</style>

🔧 Configuration

Create a docmark.config.js file in your project root:

module.exports = {
  input: './docs',
  output: './dist',
  theme: 'default',
  title: 'My Documentation',
  author: 'Your Name',
  includeCSS: true,
  minify: true
};

📚 API Reference

DocMark.convert(markdown, options)

Converts Markdown content to HTML.

Parameters:

  • markdown (string): The Markdown content to convert
  • options (object): Configuration options

Returns:

  • string: The converted HTML content

Example:

const html = DocMark.convert('# Hello\nWorld!', {
  title: 'My Document'
});

Options

Option Type Default Description
title string 'Document' Document title
theme string 'default' Theme name
includeCSS boolean true Include default CSS
minify boolean false Minify output HTML

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Running Tests

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage
npm run test:coverage

📁 Project Structure

DocMark/
├── src/
│   ├── components/
│   ├── styles/
│   ├── utils/
│   └── index.js
├── public/
├── tests/
├── docs/
├── package.json
└── README.md

🔗 Related Projects

  • MkDocs - Static site generator for documentation
  • Pandoc - Universal document converter
  • Gitiles - Git repository browser

📄 License

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

🙋‍♂️ Support

🏆 Acknowledgments

  • Thanks to all contributors who have helped shape DocMark
  • Inspired by the need for simple, efficient documentation tools
  • Built with love for the developer community

🔄 Changelog

Version 1.0.0

  • Initial release
  • Basic Markdown to HTML conversion
  • Web interface
  • Export functionality

🌐 Browser Support

Browser Version
Chrome 60+
Firefox 55+
Safari 12+
Edge 79+

Made with ❤️ by lonelypx

Star ⭐ this repository if you find it helpful!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published