[](https://badge.fury.io/py/pull-md)
[](https://opensource.org/licenses/MIT)
[](https://pepy.tech/project/pull-md)
[](https://www.linkedin.com/in/eugene-evstafev-716669181/)
# Pull.md
`pull_md` is a straightforward Python package that enables developers to convert web pages to Markdown format using the `https://pull.md/` service. It provides a simple function that accepts a URL and returns the Markdown conversion of the web page.
## Installation
Get started by installing `pull_md` using pip:
```bash
pip install pull_md
```
## Usage
`pull_md` is easy to use with a simple function that takes a URL as input and outputs the Markdown. Here's a basic example of converting a webpage to Markdown:
```python
from pull_md import pull_markdown
url = "http://example.com"
markdown = pull_markdown(url)
print(markdown)
```
This function checks the validity of the URL and retrieves the Markdown from the Pull.md service, handling any errors gracefully by providing informative messages.
**Note**: `pull_md` is capable of handling web pages that use JavaScript for rendering content, such as those built with ReactJS, Angular, or Vue.js. This makes it suitable for converting modern web applications into Markdown format.
## Features
- Simple function call to convert any URL to Markdown.
- Capable of handling JavaScript-rendered pages like those built with React, ensuring broad compatibility.
- Error handling for non-existent URLs or access issues.
- Dependency only on the requests library for HTTP requests.
## Contributing
Contributions to `pull_md` are welcome! Whether it's bug fixes, feature enhancements, or improvements to the documentation, we appreciate your help. Please feel free to fork the repository and submit pull requests.
- **Fork the Repository**: Go to [GitHub repository](https://github.com/chigwell/pull_md) and use the 'fork' button to create your own copy.
- **Clone Your Fork**: `git clone https://github.com/your-username/pull_md.git`
- **Create a Branch**: `git checkout -b your-branch-name`
- **Make Changes and Commit**: `git add .` then `git commit -m "Add some changes"`
- **Push to GitHub**: `git push origin your-branch-name`
- **Submit a Pull Request**: Open your fork on GitHub, select your branch, and click on 'Compare & pull request' button.
For more information on the development process, please check our [issues page](https://github.com/chigwell/pull_md/issues).
## License
`pull_md` is released under the [MIT License](https://choosealicense.com/licenses/mit/). Feel free to use it in any commercial or personal projects.
Raw data
{
"_id": null,
"home_page": "https://github.com/chigwell/pull_md",
"name": "pull-md",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "Eugene Evstafev",
"author_email": "chigwel@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/4a/8e/789a51cebbece8ad16f4a44e402a40f1cd0eb3c6765b95c68d2a9b5b09c2/pull_md-2025.102.1514.tar.gz",
"platform": null,
"description": "[](https://badge.fury.io/py/pull-md)\n[](https://opensource.org/licenses/MIT)\n[](https://pepy.tech/project/pull-md)\n[](https://www.linkedin.com/in/eugene-evstafev-716669181/)\n\n# Pull.md\n\n`pull_md` is a straightforward Python package that enables developers to convert web pages to Markdown format using the `https://pull.md/` service. It provides a simple function that accepts a URL and returns the Markdown conversion of the web page.\n\n## Installation\n\nGet started by installing `pull_md` using pip:\n\n```bash\npip install pull_md\n```\n\n## Usage\n\n`pull_md` is easy to use with a simple function that takes a URL as input and outputs the Markdown. Here's a basic example of converting a webpage to Markdown:\n\n```python\nfrom pull_md import pull_markdown\n\nurl = \"http://example.com\"\nmarkdown = pull_markdown(url)\nprint(markdown)\n```\n\nThis function checks the validity of the URL and retrieves the Markdown from the Pull.md service, handling any errors gracefully by providing informative messages.\n\n**Note**: `pull_md` is capable of handling web pages that use JavaScript for rendering content, such as those built with ReactJS, Angular, or Vue.js. This makes it suitable for converting modern web applications into Markdown format.\n\n## Features\n\n- Simple function call to convert any URL to Markdown.\n- Capable of handling JavaScript-rendered pages like those built with React, ensuring broad compatibility.\n- Error handling for non-existent URLs or access issues.\n- Dependency only on the requests library for HTTP requests.\n\n## Contributing\n\nContributions to `pull_md` are welcome! Whether it's bug fixes, feature enhancements, or improvements to the documentation, we appreciate your help. Please feel free to fork the repository and submit pull requests.\n\n- **Fork the Repository**: Go to [GitHub repository](https://github.com/chigwell/pull_md) and use the 'fork' button to create your own copy.\n- **Clone Your Fork**: `git clone https://github.com/your-username/pull_md.git`\n- **Create a Branch**: `git checkout -b your-branch-name`\n- **Make Changes and Commit**: `git add .` then `git commit -m \"Add some changes\"`\n- **Push to GitHub**: `git push origin your-branch-name`\n- **Submit a Pull Request**: Open your fork on GitHub, select your branch, and click on 'Compare & pull request' button.\n\nFor more information on the development process, please check our [issues page](https://github.com/chigwell/pull_md/issues).\n\n## License\n\n`pull_md` is released under the [MIT License](https://choosealicense.com/licenses/mit/). Feel free to use it in any commercial or personal projects.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A simple Python package to convert URLs to Markdown.",
"version": "2025.102.1514",
"project_urls": {
"Homepage": "https://github.com/chigwell/pull_md"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "efaf6c6b3230576c4562402c6e67ccc1ffaafa06b48bc002313deb28e903d451",
"md5": "0172fca88ddcfa4e0c0a9c14cb334066",
"sha256": "b320463504b076bae6de4f440a378c1cf4cc5dc1ad6a707341b30e7151d972bc"
},
"downloads": -1,
"filename": "pull_md-2025.102.1514-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0172fca88ddcfa4e0c0a9c14cb334066",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 4722,
"upload_time": "2025-01-02T15:14:38",
"upload_time_iso_8601": "2025-01-02T15:14:38.878288Z",
"url": "https://files.pythonhosted.org/packages/ef/af/6c6b3230576c4562402c6e67ccc1ffaafa06b48bc002313deb28e903d451/pull_md-2025.102.1514-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4a8e789a51cebbece8ad16f4a44e402a40f1cd0eb3c6765b95c68d2a9b5b09c2",
"md5": "ccee43c3c9245c243b9f25ece0a4a401",
"sha256": "33fe7d89ee8f72e7879240fd0ca3d3977ee7ecfc0073e35bcbe6a34798f10e25"
},
"downloads": -1,
"filename": "pull_md-2025.102.1514.tar.gz",
"has_sig": false,
"md5_digest": "ccee43c3c9245c243b9f25ece0a4a401",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 4015,
"upload_time": "2025-01-02T15:14:41",
"upload_time_iso_8601": "2025-01-02T15:14:41.575403Z",
"url": "https://files.pythonhosted.org/packages/4a/8e/789a51cebbece8ad16f4a44e402a40f1cd0eb3c6765b95c68d2a9b5b09c2/pull_md-2025.102.1514.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-02 15:14:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "chigwell",
"github_project": "pull_md",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pull-md"
}
JSON
