{"id":15857169,"url":"https://github.com/killshot13/mdeditor","last_synced_at":"2026-04-24T23:34:38.537Z","repository":{"id":49110384,"uuid":"324340667","full_name":"killshot13/mdEditor","owner":"killshot13","description":"Awesome markdown editor for VS Code. Supports linting and prints to HTML, PDF, and MS Word (Docx)!","archived":false,"fork":false,"pushed_at":"2023-10-23T12:13:40.000Z","size":20735,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-06T16:03:59.844Z","etag":null,"topics":["markdown","markdown-editor","markdown-to-docx","markdown-to-html","markdown-to-pdf","mdeditor","pandoc","vscode","vscode-markdown","vscode-markdown-editor"],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/killshot13.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-25T10:27:51.000Z","updated_at":"2023-10-23T11:14:27.000Z","dependencies_parsed_at":"2024-10-05T20:21:07.475Z","dependency_job_id":"e2a568fc-291f-44cc-a5f5-3845f7cf7d14","html_url":"https://github.com/killshot13/mdEditor","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/killshot13/mdEditor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/killshot13%2FmdEditor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/killshot13%2FmdEditor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/killshot13%2FmdEditor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/killshot13%2FmdEditor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/killshot13","download_url":"https://codeload.github.com/killshot13/mdEditor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/killshot13%2FmdEditor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32245150,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","markdown-editor","markdown-to-docx","markdown-to-html","markdown-to-pdf","mdeditor","pandoc","vscode","vscode-markdown","vscode-markdown-editor"],"created_at":"2024-10-05T20:21:02.132Z","updated_at":"2026-04-24T23:34:38.522Z","avatar_url":"https://github.com/killshot13.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mdEditor\n\n\u003e **Awesome Markdown Editor/Workspace for VS Code**\n\u003e\n\u003e **v2.0.0**\n\n## Table of Contents\n\n- [About](#about)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n- [Usage](#usage)\n- [References](#references)\n\n\u003ca href=\"https://github.com/killshot13/mdEditor\"\u003e\u003cimg align=\"right\" width=\"605\" height=\"395\" src=\"https://github.com/killshot13/mdEditor/blob/main/images/markdown-to-html.jpg\" alt=\"HTML file created with mdEditor\"\u003e\u003c/a\u003e\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/killshot13/mdEditor\"\u003e\u003cimg width=\"605\" height=\"395\" src=\"https://github.com/killshot13/mdEditor/blob/main/images/markdown-to-docx.jpg\" alt=\"DOCX file created with mdEditor\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## About \u003ca name = \"about\"\u003e\u003c/a\u003e\n\n### Features\n\n- Auto-checks for errors/problems and generates a detailed output for any broken rules.\n\n- Lints and runs auto-fix on save which will correct/reformat most common errors.\n\n- Supports the creation of `.pdf`, `.docx`, and `.html` files, which can be exported and viewed with MS Word, Adobe Acrobat, or the browser.\n\n- Enforces syntax for any markdown flavor with a simple on/off option for every rule.\n\n- All `html` files are linked to a basic stylesheet during creation so they look natural if viewed with the browser.\n\n### Details\n\nmdEditor provides the configuration guidelines and creates the structure for an awesome VSCode Markdown editor. By creating a reusable `code-workspace`, the main portion of your IDE environment is protected from rule conflicts.\n\nUnless you work with Markdown on a daily basis, the editor is designed to be installed locally at the user level. Markdown files can be created in the editor workspace, and existing files imported as needed for easy linting.\n\nmdEditor is an adaptation derived from the brainchild of [Dave Johnson](https://twitter.com/thisDaveJ), which he detailed a couple years ago in [an article](https://thisdavej.com/build-an-amazing-markdown-editor-using-visual-studio-code-and-pandoc/) on his blog.\n\n---\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/killshot13/mdEditor\"\u003e\u003cimg width=\"780\" height=\"520\" src=\"https://github.com/killshot13/mdEditor/blob/main/images/mdEditor.gif\" alt=\"GIF file showing how mdEditor works\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Prerequisites \u003ca name = \"prerequisites\"\u003e\u003c/a\u003e\n\n**[Visual Studio Code](https://code.visualstudio.com/Download)**\nThis should be self-explanatory.\n\n**[Pandoc](http://pandoc.org/installing.html)**\nThis may require some guidance if you don't currently use Pandoc. I wrote a gist to help first-time users; here is [the link](https://gist.github.com/killshot13/5b379355d275e79a5cb1f03c841c7d53).\n\n### Installation \u003ca name = \"installation\"\u003e\u003c/a\u003e\n\nDecide where the core mdEditor files should live on your local drive (reference [About](#about) for more), then clone [mdEditor](https://github.com/killshot13/mdEditor.git) to that location.\n\nNow, open mdEditor at the base directory using VSCode. Your IDE will auto-discover the `.code-workspace` file and prompt you to reopen the folder as a workspace. Confirm this choice, unless you wish to use a different configuration.\n\nIf so, there is a blank `settings.json` in the `.vscode` folder for you. Otherwise, you should disregard said folder completely.\n\nWe still need to pass the linting rules and Pandoc style guide to the editor workspace.\n\nYou should have noticed a prompt once you entered the workspace about installing the recommended extensions. If you have not done so already, go ahead and approve the install.\n\nIf for some reason you did not receive a prompt or have already closed the notification tab, not to worry. Just install these VSCode extensions, leaving the settings at their default values.\n\n--\u003e [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint)\n\n--\u003e [vscode-pandoc](https://marketplace.visualstudio.com/items?itemName=ChrisChinchilla.vscode-pandoc)\n\n### Tree View\n\nNow, using this diagram, verify the file structure of your local mdEditor is free from any discrepancies.\n\n##### _mdEditor/_\n\n - [.github](./.github)\n   - [ISSUE_TEMPLATE](./.github/ISSUE_TEMPLATE)\n\t \t- [bug_report.md](./.github/ISSUE_TEMPLATE/bug_report.md)\n\t\t- [custom.md](./.github/ISSUE_TEMPLATE/custom.md)\n\t\t- [feature_request.md](./.github/ISSUE_TEMPLATE/feature_request.md)\n\t- [CONTRIBUTING.md](./.github/CONTRIBUTING.md)\n\t- [ISSUE_TEMPLATE.md](./.github/ISSUE_TEMPLATE.md)\n\t- [PULL_REQUEST_TEMPLATE.md](./.github/PULL_REQUEST_TEMPLATE.md)\n - [.vscode](./.vscode)\n\t - [extensions.json](./.vscode/extensions.json)\n\t - [settings.json](./.vscode/settings.json)\n - [images](./images)\n   - [markdown-to-docx.jpg](./images/markdown-to-docx.jpg)\n   - [markdown-to-html.jpg](./images/markdown-to-html.jpg)\n   - [markdown-to-pdf.jpg](./images/markdown-to-pdf.jpg)\n   - [mdEditor.gif](./images/mdEditor.gif)\n - [CHANGELOG.md](./CHANGELOG.md)\n - [LICENSE](./LICENSE)\n - [md](./md)\n   - [test.txt](./md/test.txt)\n - [mdEditor.code-workspace](./mdEditor.code-workspace)\n - [styles](./styles)\n   - [style.css](./styles/style.css)\n   - [rules.md](./styles/rules.md)\n - [README.md](./README.md)\n\nIf the file structure matches, installation is complete. Well done!\n\n\u003e **NOTE: If using Linux you must uncomment the `pandoc.htmlOptString` in the `mdEditor.code-workspace` file. The current version, which uses Windows OS file separators, must be replaced with the Linux version; otherwise, the css styles will not be applied correctly.**\n\n## Usage \u003ca name = \"usage\"\u003e\u003c/a\u003e\n\nTo test linting \u0026 formatting, click the `test.txt` file (in the `md` folder); it should open in the main editor window.\n\nIn the sidebar, keeping the `test.txt` tab in focus, change the filetype from `txt` to `md` and save.\n\nCheck the output in the PROBLEMS tab of your lower (terminal) panel. Several formatting violations should appear. Now make a tiny edit and save again. Most of the errors should be gone, having been corrected automatically.\n\nTo test the filetype output, enter the key combination `CTRL + K`, then press `P`. Options to create `.pdf`, `.docx`, or `.html` file should appear in the dropdown. Click each option in turn and confirm the desired result was produced.\n\nWorkspace setup is now complete and mdEditor is ready to use.\n\n\u003eNOTE: The `syntax.md` file in the `styles` folder contains a detailed description of the linting rules available within the editor workspace. Most linting rules can be simply toggled on/off by editing the `.markdownlint.json` file using this syntax.\n\n```json\n{\n\t\"MD-XXX\": Boolean\n}\n```\n\nHappy markdown'ing! :)\n\n[mdEditor](https://github.com/killshot13/mdEditor) is free software released under the [MIT license](https://github.com/killshot13/mdEditor/blob/main/LICENSE). Copyright 2020-2021 Michael Rehnert\n\n## References \u003ca name = \"references\"\u003e\u003c/a\u003e\n\n_Extensive credit is owed to [Dave Johnson](https://twitter.com/thisDaveJ) for inspiring me to create mdEditor after reading [this guide](https://thisdavej.com/build-an-amazing-markdown-editor-using-visual-studio-code-and-pandoc) he authored._\n\n_Additional credit and appreciation is extended to the creators, contributors, and maintainers of the following open-source software projects._\n\n[markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) is free software released under the [MIT license](https://marketplace.visualstudio.com/items/DavidAnson.vscode-markdownlint/license). Copyright (c) David Anson\n\n[vscode-pandoc](https://marketplace.visualstudio.com/items?itemName=ChrisChinchilla.vscode-pandoc) is free software released under the [MIT license](https://marketplace.visualstudio.com/items/ChrisChinchilla.vscode-pandoc/license). Copyright (c) 2023 Chris Ward / aka Chris Chinchilla\n\n[Pandoc](https://pandoc.org) is free software released under the [GPL](https://www.gnu.org/licenses/gpl-3.0.html). Copyright 2006–2022 [John MacFarlane](https://johnmacfarlane.net).\n\n[VS Code](https://code.visualstudio.com/) is free software released under the [MIT license](https://github.com/microsoft/vscode/blob/main/LICENSE.txt). The project's [source code](https://github.com/microsoft/vscode) is available on GitHub. Copyright (c) 2015 - present [Microsoft Corporation](https://www.microsoft.com)\n\nAll software programs, extensions, plugins, and digital content referenced and/or used in the documentation and/or installation guide of mdEditor is the respective intellectual property of the creators, developers, and owners thereof and is entitled to the protections granted under U.S. Copyright law.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkillshot13%2Fmdeditor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkillshot13%2Fmdeditor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkillshot13%2Fmdeditor/lists"}