{"id":37472282,"url":"https://github.com/mjwsteenbergen/markender","last_synced_at":"2026-01-16T07:17:21.080Z","repository":{"id":43936515,"uuid":"82935723","full_name":"mjwsteenbergen/markender","owner":"mjwsteenbergen","description":"WebComponents to enhance your reports","archived":false,"fork":false,"pushed_at":"2023-01-07T19:07:15.000Z","size":34120,"stargazers_count":44,"open_issues_count":52,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2023-04-05T18:11:47.429Z","etag":null,"topics":["bibliography","markdown","markdown-it","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=mjwsteenbergen.markender","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mjwsteenbergen.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-02-23T14:34:09.000Z","updated_at":"2022-09-13T11:06:19.000Z","dependencies_parsed_at":"2023-02-07T22:01:15.300Z","dependency_job_id":null,"html_url":"https://github.com/mjwsteenbergen/markender","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/mjwsteenbergen/markender","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjwsteenbergen%2Fmarkender","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjwsteenbergen%2Fmarkender/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjwsteenbergen%2Fmarkender/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjwsteenbergen%2Fmarkender/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mjwsteenbergen","download_url":"https://codeload.github.com/mjwsteenbergen/markender/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjwsteenbergen%2Fmarkender/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478047,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"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":["bibliography","markdown","markdown-it","vscode","vscode-extension"],"created_at":"2026-01-16T07:17:20.992Z","updated_at":"2026-01-16T07:17:21.066Z","avatar_url":"https://github.com/mjwsteenbergen.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Markender\n\nDo you love using markdown? Do you wish you could use it for reports? With Markender you can!\n\nIt includes everything you need to create an amazing report:\n - Cover-pages\n - Table of contents\n - Formulas\n - Checklists\n - Image-referencing\n - Bibliography\n\nStyle it just the way you want with the following built in styles:\n - Latex\n - Dropbox\n - Github\n - Somnox\n - ACM (work in progress)\n\n![the features](./docs/animation.gif)\n\n# All Components\nBy using [web-components](https://developer.mozilla.org/en-US/docs/Web/Web_Components) we make additions easy and simple. Furthermore, if one does not have the extension, they see nothing! The following web components are defined and can be used within vscode:\n## md-bib-item\n\n\n\n\u003c!-- Auto Generated Below --\u003e\n\n\n## Properties\n\n| Property  | Attribute | Description | Type          | Default     |\n| --------- | --------- | ----------- | ------------- | ----------- |\n| `bibitem` | --        |             | `BibtexEntry` | `undefined` |\n| `name`    | `name`    |             | `string`      | `undefined` |\n\n\n## md-bib\nFor the loading of the bibliography and doi-references you need to disable security with `Markdown: Change Preview Security Settings`\nThe citation key is shown between brackets, to help you quickly find that reference. It will automatically be removed when converting to pdf.\n\nThe format property of the `md-bib` element will say how the element will display its reference. For example `format=\"Hello World\"` will make all reference have the form of `[Hello World]`. Within this format you can use a few variables. These are notated in the form of `{variableName}`. The following can be used within formatting:\n - `{refnumber}`: Will display the reference number of the item\n - `{authors}`: Will show all authors\n - `{author}`: Will try to show only the first author and add `et al.` if there are more than one.\n - `{year}`: The year when the item was published. For `md-bib-url` this is the current year.\n\n### Reference from doi\n`\u003cmd-bib-doi\u003e${doi}\u003c/md-bib-doi\u003e` will tell the bibliography to get a reference from the given doi.\n\n| Property | Description                                           |\n|----------| ---------|\n| id       | The citation key of the reference                     |\n\nExample:\n\n```\n\u003cmd-bib\u003e\n    \u003cmd-bib-doi\u003e10.1109/5.771073\u003c/md-bib-doi\u003e\n\u003c/md-bib\u003e\n```\n\n### Reference from url\n`\u003cmd-bib-url\u003e${url}\u003c/md-bib-url\u003e` will tell the bibliography to get a reference from the given url.\n\n| Property | Description                                           |\n|----------| ---------|\n| id       | The citation key of the reference                     |\n| accessed | The date of when the reference was accessed in the form `year-month-day` |\n\nExample:\n\n```\n\u003cmd-bib\u003e\n    \u003cmd-bib-url\u003ehttps://github.com/mjwsteenbergen/markender\u003c/md-bib-url\u003e\n\u003c/md-bib\u003e\n```\n\n\u003c!-- Auto Generated Below --\u003e\n\n\n## Properties\n\n| Property | Attribute | Description                                                                                   | Type     | Default         |\n| -------- | --------- |   - | -------- | --------------- |\n| `format` | `format`  | How to format the references)                                                                 | `string` | `\"{refnumber}\"` |\n| `src`    | `src`     | Source of the bibliography (this should be in [bibtex](http://www.bibtex.org/Format/) format) | `string` | `undefined`     |\n\n\n## md-cover\n`\u003cmd-cover\u003e\u003c/md-cover\u003e` will create a cover page at the place you put it.\n\n\u003c!-- Auto Generated Below --\u003e\n\n\n## Properties\n\n| Property | Attribute | Description          | Type     | Default                               |\n| -------- | --------- | -------------------- | -------- | ------------------------------------- |\n| `author` | `author`  | Author of the report | `string` | `undefined`                           |\n| `date`   | `date`    |                      | `string` | `new Date(Date.now()).toDateString()` |\n| `title`  | `title`   | Title of the report  | `string` | `undefined`                           |\n\n\n \n\n\n## md-img\nBy default any image (`![alt](https://upload.wikimedia.org/wikipedia/commons/thumb/4/48/Markdown-mark.svg/128px-Markdown-mark.svg.png)`) is converted to a `\u003cmd-img\u003e\u003c/md-img\u003e` element.\n\nHowever, there might be a few cases, where it would be useful to use the element alone.\n\nTo change the size of the image add the words: `full,medium,small or super-small` to change the size of the image like so: `\u003cmd-img small\u003e\u003c/md-img\u003e` \n\n### Collages\n\nMarkdown does not contain a specification to have images on the same line. This extension adds this functionality\n\n\nExample:\n![collage](./docs/collage.png)\nin markdown:\n\n```html\n\u003cul collage\u003e\n    \u003cmd-img src='https://images.unsplash.com/reserve/91JuTaUSKaMh2yjB1C4A_IMG_9284.jpg' alt='Picture'\u003e\u003c/md-img\u003e\n    \u003cmd-img src='https://images.unsplash.com/reserve/91JuTaUSKaMh2yjB1C4A_IMG_9284.jpg' alt='Picture'\u003e\u003c/md-img\u003e\n    \u003cmd-img src='https://images.unsplash.com/reserve/91JuTaUSKaMh2yjB1C4A_IMG_9284.jpg' alt='Picture'\u003e\u003c/md-img\u003e\n\u003c/ul\u003e\n```\n\n\u003c!-- Auto Generated Below --\u003e\n\n\n## Properties\n\n| Property | Attribute | Description                                           | Type     | Default              |\n| -------- | --------- |  ------- | -------- | -------------------- |\n| `align`  | `align`   | How to align the image                                | `string` | `\"center\"`           |\n| `alt`    | `alt`     | Description of the image that is displayed below      | `string` | `undefined`          |\n| `rank`   | `rank`    | The figure number. Do not add. Is added automatically | `number` | `undefined`          |\n| `refId`  | `ref-id`  | How to reference the figure using the \\[ref\\] format  | `string` | `\"fig:\" + this.rank` |\n| `src`    | `src`     | Source of the image                                   | `string` | `undefined`          |\n\n\n \n\n\n## md-style\nThe property name can have the values shown when using the snippet `style` within markdown. Append the `name` property with `disable_style` to disable the style used by vscode and show the text as it will be printed.\n\nmargin can have one value (top, bottom, left, right), two ((top, bottom), (left, right)) or four (top, right, bottom, left)\n\nurl will get the contents of the stylesheet and set add it to the document. This will also disable the margin property, so if wanted needs to be set in the stylesheet.\ncar\n\n\u003c!-- Auto Generated Below --\u003e\n\n\n## Properties\n\n| Property | Attribute | Description                    | Type     | Default        |\n| -------- | --------- | ------------------------------ | -------- | -------------- |\n| `margin` | `margin`  | Margin of the printed page     | `string` | `\"80px 120px\"` |\n| `name`   | `name`    | The style it should assume     | `string` | `undefined`    |\n| `url`    | `url`     | The url of your personal sheet | `string` | `undefined`    |\n\n\n----------------------------------------------\n\n\n## md-toc\n`\u003cmd-toc\u003e\u003c/md-toc\u003e` will create a new chapter and the bibliography.\n\n\u003c!-- Auto Generated Below --\u003e\n\n\n## Properties\n\n| Property   | Attribute  | Description                                     | Type      | Default |\n| ---------- | ---------- |  - | --------- | ------- |\n| `chapters` | `chapters` | Flag to display chapter numbers before chapters | `boolean` | `true`  |\n\n\n## Extra functionality\n\nFormula's with latex-math syntax can be used by using double dollar signs. For all possibilties look at [this resource](https://en.wikibooks.org/wiki/LaTeX/Mathematics). \n\nExample:\n```\n$$\\forall x \\in X, \\quad \\exists y \\leq \\epsilon$$\n```\n\nTodos can be used by using the following syntax:\n\n```\n - [ ] Open todo\n - [X] Completed todo\n```\n\n## Convert your document to PDF\n\nYou can use [Markdown Converter](https://marketplace.visualstudio.com/items?itemName=manuth.markdown-converter) to convert your document to pdf!\n\nMake sure to use the following settings to make it very pretty:\n\n```\n    \"markdownConverter.Document.HeaderFooterEnabled\": false,\n    \"markdownConverter.Document.Paper.Margin\": { \"Top\": \"0\", \"Bottom\": \"0\", \"Left\": \"0\", \"Right\": \"0\"}\n```\n\n# Change Log\n## 2.0.1\n - Fix CI\n\n## 2.0.0\n - Moved from vanilla web components to StencilJS to make adding new features easier\n - Fixed md-bib-url snippet\n - Show all references by default\n - Add bibliography export\n - Table of contents\n   - Same chapter titles no longer clash\n   - Chapter names with weird characters are now correctly linkable\n   - Chapters are referencable\n\n## 1.5.1\n - Bug fixes\n   - Switch to https when getting bibliography from doi\n\n## 1.5.0\n - Bug fixes\n    - Checkbox works again\n    - Update vulnerable packages\n    \n## 1.4.0\n - Remove command\n - Page margins are now set using md-style, until better solution can be found\n - `md-bib-url` now has accessed property\n - Rebuilt link-storage for new functionality\n   - ordering\n   - removing unused references\n\n## 1.3.0\n - Multiple references at once!\n - You can now reference anything that BibTex can!\n - More options to format your references\n\n## 1.2.0\n- Combine vscode styles and document styles\n- Show citation key in bibliography\n\n## 1.1.0\n- Move css to actual css files\n- Remove css from ts components\n- Improve acm\n\n## 1.0.1\nImprove documentation\n\n## 1.0.0\nInitial Release!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmjwsteenbergen%2Fmarkender","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmjwsteenbergen%2Fmarkender","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmjwsteenbergen%2Fmarkender/lists"}