diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2023-02-20 13:49:51 +0000 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2023-02-20 13:49:51 +0000 |
commit | 71786ddc8e28fbd3cb3fcc4b3ff15e5962a1c82e (patch) | |
tree | 6a2d93ef3fb2d353bb7739e4b57e6541f51cdd71 /glfm_specification | |
parent | a7253423e3403b8c08f8a161e5937e1488f5f407 (diff) | |
download | gitlab-ce-71786ddc8e28fbd3cb3fcc4b3ff15e5962a1c82e.tar.gz |
Add latest changes from gitlab-org/gitlab@15-9-stable-eev15.9.0-rc42
Diffstat (limited to 'glfm_specification')
11 files changed, 758 insertions, 806 deletions
diff --git a/glfm_specification/input/gitlab_flavored_markdown/glfm_example_status.yml b/glfm_specification/input/gitlab_flavored_markdown/glfm_example_status.yml index 501d06692ea..03d9a2aea33 100644 --- a/glfm_specification/input/gitlab_flavored_markdown/glfm_example_status.yml +++ b/glfm_specification/input/gitlab_flavored_markdown/glfm_example_status.yml @@ -12,13 +12,13 @@ skip_running_snapshot_static_html_tests: false # NOT YET SUPPORTED skip_running_snapshot_wysiwyg_html_tests: false skip_running_snapshot_prosemirror_json_tests: false -07_02_00__gitlab_official_specification_markdown__task_list_items__003: +07_01_00__gitlab_official_specification_markdown__task_list_items__003: skip_update_example_snapshot_html_wysiwyg: Inapplicable task list items not yet implemented for WYSYWIG skip_update_example_snapshot_prosemirror_json: Inapplicable task list items not yet implemented for WYSYWIG skip_running_conformance_wysiwyg_tests: Inapplicable task list items not yet implemented for WYSYWIG skip_running_snapshot_wysiwyg_html_tests: Inapplicable task list items not yet implemented for WYSYWIG skip_running_snapshot_prosemirror_json_tests: Inapplicable task list items not yet implemented for WYSYWIG -07_02_00__gitlab_official_specification_markdown__task_list_items__004: +07_01_00__gitlab_official_specification_markdown__task_list_items__004: skip_update_example_snapshot_html_wysiwyg: Inapplicable task list items not yet implemented for WYSYWIG skip_update_example_snapshot_prosemirror_json: Inapplicable task list items not yet implemented for WYSYWIG skip_running_conformance_wysiwyg_tests: Inapplicable task list items not yet implemented for WYSYWIG diff --git a/glfm_specification/input/gitlab_flavored_markdown/glfm_internal_extensions.md b/glfm_specification/input/gitlab_flavored_markdown/glfm_internal_extensions.md index 63518a93f71..266e1c7723d 100644 --- a/glfm_specification/input/gitlab_flavored_markdown/glfm_internal_extensions.md +++ b/glfm_specification/input/gitlab_flavored_markdown/glfm_internal_extensions.md @@ -746,4 +746,35 @@ Attributes must immediately follow the image markdown. <p><img src="https://gitlab.com/logo.png"> {width="100" height="100"}</p> ```````````````````````````````` +## Footnotes + +See +[the footnotes section of the user-facing documentation for GitLab Flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html#footnotes). + +```````````````````````````````` example gitlab +footnote reference tag [^fortytwo] + +[^fortytwo]: footnote text +. +<p> +footnote reference tag +<sup> +<a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref> +1 +</a> +</sup> +</p> +<section data-footnotes> +<ol> +<li id="fn-fortytwo-42"> +<p> +footnote text +<a href="#fnref-fortytwo-42" data-footnote-backref> +</a> +</p> +</li> +</ol> +</section> +```````````````````````````````` + <!-- END TESTS --> diff --git a/glfm_specification/input/gitlab_flavored_markdown/glfm_official_specification.md b/glfm_specification/input/gitlab_flavored_markdown/glfm_official_specification.md index bab74857cc3..03abace19a4 100644 --- a/glfm_specification/input/gitlab_flavored_markdown/glfm_official_specification.md +++ b/glfm_specification/input/gitlab_flavored_markdown/glfm_official_specification.md @@ -1,6 +1,15 @@ +--- +title: GitLab Flavored Markdown (GLFM) Spec +version: alpha +... + # Introduction -TODO: Write a GitLab-specific version of the GitHub Flavored Markdown intro section. +GitLab Flavored Markdown (GLFM) extends the [CommonMark specification](https://spec.commonmark.org/current/) and is considered a strict superset of CommonMark. It also incorporates the extensions defined by the [GitHub Flavored Markdown specification](https://github.github.com/gfm/). + +This specification will define the various official extensions that comprise GLFM. These extensions are GitLab independent - they do not require a GitLab server for parsing or interaction. The intent is to provide a specification that can be implemented in standard markdown editors. This includes many of the features listed in [user-facing documentation for GitLab Flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html). + +The CommonMark and GitHub specifications will not be duplicated here. NOTE: The example numbering in this document does not start at "1", because this official specification only contains a subset of all the examples which are supported by GitLab Flavored Markdown. See @@ -15,45 +24,13 @@ for a complete list of all examples, which are a superset of examples from: <!-- BEGIN TESTS --> # GitLab Official Specification Markdown -Currently, only some of the GitLab-specific markdown features are -listed in this section. We may eventually add all -GitLab-specific features currently listed as supported in the +Note: This specification is a work in progress. Only some of the official GLFM extensions +are defined. We will continue to add any additional ones found in the [user-facing documentation for GitLab Flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html). There is currently only this single top-level heading, but the examples may be split into multiple top-level headings in the future. -## Footnotes - -See -[the footnotes section of the user-facing documentation for GitLab Flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html#footnotes). - -```````````````````````````````` example gitlab -footnote reference tag [^fortytwo] - -[^fortytwo]: footnote text -. -<p> -footnote reference tag -<sup> -<a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref> -1 -</a> -</sup> -</p> -<section data-footnotes> -<ol> -<li id="fn-fortytwo-42"> -<p> -footnote text -<a href="#fnref-fortytwo-42" data-footnote-backref> -</a> -</p> -</li> -</ol> -</section> -```````````````````````````````` - ## Task list items See diff --git a/glfm_specification/output_example_snapshots/examples_index.yml b/glfm_specification/output_example_snapshots/examples_index.yml index d08f16c7313..da9420ffa85 100644 --- a/glfm_specification/output_example_snapshots/examples_index.yml +++ b/glfm_specification/output_example_snapshots/examples_index.yml @@ -2012,246 +2012,246 @@ 06_15_00__inlines__textual_content__003: spec_example_position: 673 source_specification: commonmark -07_01_00__gitlab_official_specification_markdown__footnotes__001: +07_01_00__gitlab_official_specification_markdown__task_list_items__001: spec_example_position: 674 source_specification: gitlab -07_02_00__gitlab_official_specification_markdown__task_list_items__001: +07_01_00__gitlab_official_specification_markdown__task_list_items__002: spec_example_position: 675 source_specification: gitlab -07_02_00__gitlab_official_specification_markdown__task_list_items__002: +07_01_00__gitlab_official_specification_markdown__task_list_items__003: spec_example_position: 676 source_specification: gitlab -07_02_00__gitlab_official_specification_markdown__task_list_items__003: +07_01_00__gitlab_official_specification_markdown__task_list_items__004: spec_example_position: 677 source_specification: gitlab -07_02_00__gitlab_official_specification_markdown__task_list_items__004: +07_02_00__gitlab_official_specification_markdown__front_matter__001: spec_example_position: 678 source_specification: gitlab -07_03_00__gitlab_official_specification_markdown__front_matter__001: +07_02_00__gitlab_official_specification_markdown__front_matter__002: spec_example_position: 679 source_specification: gitlab -07_03_00__gitlab_official_specification_markdown__front_matter__002: +07_02_00__gitlab_official_specification_markdown__front_matter__003: spec_example_position: 680 source_specification: gitlab -07_03_00__gitlab_official_specification_markdown__front_matter__003: +07_02_00__gitlab_official_specification_markdown__front_matter__004: spec_example_position: 681 source_specification: gitlab -07_03_00__gitlab_official_specification_markdown__front_matter__004: +07_02_00__gitlab_official_specification_markdown__front_matter__005: spec_example_position: 682 source_specification: gitlab -07_03_00__gitlab_official_specification_markdown__front_matter__005: +07_03_00__gitlab_official_specification_markdown__table_of_contents__001: spec_example_position: 683 source_specification: gitlab -07_04_00__gitlab_official_specification_markdown__table_of_contents__001: +07_03_00__gitlab_official_specification_markdown__table_of_contents__002: spec_example_position: 684 source_specification: gitlab -07_04_00__gitlab_official_specification_markdown__table_of_contents__002: +07_03_00__gitlab_official_specification_markdown__table_of_contents__003: spec_example_position: 685 source_specification: gitlab -07_04_00__gitlab_official_specification_markdown__table_of_contents__003: +07_03_00__gitlab_official_specification_markdown__table_of_contents__004: spec_example_position: 686 source_specification: gitlab -07_04_00__gitlab_official_specification_markdown__table_of_contents__004: +08_01_00__gitlab_internal_extension_markdown__audio__001: spec_example_position: 687 source_specification: gitlab -08_01_00__gitlab_internal_extension_markdown__audio__001: +08_01_00__gitlab_internal_extension_markdown__audio__002: spec_example_position: 688 source_specification: gitlab -08_01_00__gitlab_internal_extension_markdown__audio__002: +08_02_00__gitlab_internal_extension_markdown__video__001: spec_example_position: 689 source_specification: gitlab -08_02_00__gitlab_internal_extension_markdown__video__001: +08_02_00__gitlab_internal_extension_markdown__video__002: spec_example_position: 690 source_specification: gitlab -08_02_00__gitlab_internal_extension_markdown__video__002: +08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__001: spec_example_position: 691 source_specification: gitlab -08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__001: +08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__002: spec_example_position: 692 source_specification: gitlab -08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__002: +08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__003: spec_example_position: 693 source_specification: gitlab -08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__003: +08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__004: spec_example_position: 694 source_specification: gitlab -08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__004: +08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__005: spec_example_position: 695 source_specification: gitlab -08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__005: +08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__006: spec_example_position: 696 source_specification: gitlab -08_03_00__gitlab_internal_extension_markdown__markdown_preview_api_request_overrides__006: +08_04_01__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_image_for_group__001: spec_example_position: 697 source_specification: gitlab -08_04_01__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_image_for_group__001: +08_04_02__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_image_for_project__001: spec_example_position: 698 source_specification: gitlab -08_04_02__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_image_for_project__001: +08_04_03__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_image_for_project_wiki__001: spec_example_position: 699 source_specification: gitlab -08_04_03__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_image_for_project_wiki__001: +08_04_04__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_link_for_group__001: spec_example_position: 700 source_specification: gitlab -08_04_04__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_link_for_group__001: +08_04_05__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_link_for_project__001: spec_example_position: 701 source_specification: gitlab -08_04_05__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_link_for_project__001: +08_04_06__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_link_for_project_wiki__001: spec_example_position: 702 source_specification: gitlab -08_04_06__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_link_for_project_wiki__001: +08_04_07__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_link_for_group_wiki__001: spec_example_position: 703 source_specification: gitlab -08_04_07__gitlab_internal_extension_markdown__migrated_golden_master_examples__attachment_link_for_group_wiki__001: +08_04_08__gitlab_internal_extension_markdown__migrated_golden_master_examples__audio__001: spec_example_position: 704 source_specification: gitlab -08_04_08__gitlab_internal_extension_markdown__migrated_golden_master_examples__audio__001: +08_04_09__gitlab_internal_extension_markdown__migrated_golden_master_examples__audio_and_video_in_lists__001: spec_example_position: 705 source_specification: gitlab -08_04_09__gitlab_internal_extension_markdown__migrated_golden_master_examples__audio_and_video_in_lists__001: +08_04_10__gitlab_internal_extension_markdown__migrated_golden_master_examples__blockquote__001: spec_example_position: 706 source_specification: gitlab -08_04_10__gitlab_internal_extension_markdown__migrated_golden_master_examples__blockquote__001: +08_04_11__gitlab_internal_extension_markdown__migrated_golden_master_examples__bold__001: spec_example_position: 707 source_specification: gitlab -08_04_11__gitlab_internal_extension_markdown__migrated_golden_master_examples__bold__001: +08_04_12__gitlab_internal_extension_markdown__migrated_golden_master_examples__bullet_list_style_1__001: spec_example_position: 708 source_specification: gitlab -08_04_12__gitlab_internal_extension_markdown__migrated_golden_master_examples__bullet_list_style_1__001: +08_04_13__gitlab_internal_extension_markdown__migrated_golden_master_examples__bullet_list_style_2__001: spec_example_position: 709 source_specification: gitlab -08_04_13__gitlab_internal_extension_markdown__migrated_golden_master_examples__bullet_list_style_2__001: +08_04_14__gitlab_internal_extension_markdown__migrated_golden_master_examples__bullet_list_style_3__001: spec_example_position: 710 source_specification: gitlab -08_04_14__gitlab_internal_extension_markdown__migrated_golden_master_examples__bullet_list_style_3__001: +08_04_15__gitlab_internal_extension_markdown__migrated_golden_master_examples__code_block_javascript__001: spec_example_position: 711 source_specification: gitlab -08_04_15__gitlab_internal_extension_markdown__migrated_golden_master_examples__code_block_javascript__001: +08_04_16__gitlab_internal_extension_markdown__migrated_golden_master_examples__code_block_plaintext__001: spec_example_position: 712 source_specification: gitlab -08_04_16__gitlab_internal_extension_markdown__migrated_golden_master_examples__code_block_plaintext__001: +08_04_17__gitlab_internal_extension_markdown__migrated_golden_master_examples__code_block_unknown__001: spec_example_position: 713 source_specification: gitlab -08_04_17__gitlab_internal_extension_markdown__migrated_golden_master_examples__code_block_unknown__001: +08_04_18__gitlab_internal_extension_markdown__migrated_golden_master_examples__color_chips__001: spec_example_position: 714 source_specification: gitlab -08_04_18__gitlab_internal_extension_markdown__migrated_golden_master_examples__color_chips__001: +08_04_19__gitlab_internal_extension_markdown__migrated_golden_master_examples__description_list__001: spec_example_position: 715 source_specification: gitlab -08_04_19__gitlab_internal_extension_markdown__migrated_golden_master_examples__description_list__001: +08_04_20__gitlab_internal_extension_markdown__migrated_golden_master_examples__details__001: spec_example_position: 716 source_specification: gitlab -08_04_20__gitlab_internal_extension_markdown__migrated_golden_master_examples__details__001: +08_04_21__gitlab_internal_extension_markdown__migrated_golden_master_examples__diagram_kroki_nomnoml__001: spec_example_position: 717 source_specification: gitlab -08_04_21__gitlab_internal_extension_markdown__migrated_golden_master_examples__diagram_kroki_nomnoml__001: +08_04_22__gitlab_internal_extension_markdown__migrated_golden_master_examples__diagram_plantuml__001: spec_example_position: 718 source_specification: gitlab -08_04_22__gitlab_internal_extension_markdown__migrated_golden_master_examples__diagram_plantuml__001: +08_04_23__gitlab_internal_extension_markdown__migrated_golden_master_examples__diagram_plantuml_unicode__001: spec_example_position: 719 source_specification: gitlab -08_04_23__gitlab_internal_extension_markdown__migrated_golden_master_examples__diagram_plantuml_unicode__001: +08_04_24__gitlab_internal_extension_markdown__migrated_golden_master_examples__div__001: spec_example_position: 720 source_specification: gitlab -08_04_24__gitlab_internal_extension_markdown__migrated_golden_master_examples__div__001: +08_04_25__gitlab_internal_extension_markdown__migrated_golden_master_examples__emoji__001: spec_example_position: 721 source_specification: gitlab -08_04_25__gitlab_internal_extension_markdown__migrated_golden_master_examples__emoji__001: +08_04_26__gitlab_internal_extension_markdown__migrated_golden_master_examples__emphasis__001: spec_example_position: 722 source_specification: gitlab -08_04_26__gitlab_internal_extension_markdown__migrated_golden_master_examples__emphasis__001: +08_04_27__gitlab_internal_extension_markdown__migrated_golden_master_examples__figure__001: spec_example_position: 723 source_specification: gitlab -08_04_27__gitlab_internal_extension_markdown__migrated_golden_master_examples__figure__001: +08_04_28__gitlab_internal_extension_markdown__migrated_golden_master_examples__footnotes__001: spec_example_position: 724 source_specification: gitlab -08_04_28__gitlab_internal_extension_markdown__migrated_golden_master_examples__footnotes__001: +08_04_29__gitlab_internal_extension_markdown__migrated_golden_master_examples__frontmatter_json__001: spec_example_position: 725 source_specification: gitlab -08_04_29__gitlab_internal_extension_markdown__migrated_golden_master_examples__frontmatter_json__001: +08_04_30__gitlab_internal_extension_markdown__migrated_golden_master_examples__frontmatter_toml__001: spec_example_position: 726 source_specification: gitlab -08_04_30__gitlab_internal_extension_markdown__migrated_golden_master_examples__frontmatter_toml__001: +08_04_31__gitlab_internal_extension_markdown__migrated_golden_master_examples__frontmatter_yaml__001: spec_example_position: 727 source_specification: gitlab -08_04_31__gitlab_internal_extension_markdown__migrated_golden_master_examples__frontmatter_yaml__001: +08_04_32__gitlab_internal_extension_markdown__migrated_golden_master_examples__hard_break__001: spec_example_position: 728 source_specification: gitlab -08_04_32__gitlab_internal_extension_markdown__migrated_golden_master_examples__hard_break__001: +08_04_33__gitlab_internal_extension_markdown__migrated_golden_master_examples__headings__001: spec_example_position: 729 source_specification: gitlab -08_04_33__gitlab_internal_extension_markdown__migrated_golden_master_examples__headings__001: +08_04_34__gitlab_internal_extension_markdown__migrated_golden_master_examples__horizontal_rule__001: spec_example_position: 730 source_specification: gitlab -08_04_34__gitlab_internal_extension_markdown__migrated_golden_master_examples__horizontal_rule__001: +08_04_35__gitlab_internal_extension_markdown__migrated_golden_master_examples__html_marks__001: spec_example_position: 731 source_specification: gitlab -08_04_35__gitlab_internal_extension_markdown__migrated_golden_master_examples__html_marks__001: +08_04_36__gitlab_internal_extension_markdown__migrated_golden_master_examples__image__001: spec_example_position: 732 source_specification: gitlab -08_04_36__gitlab_internal_extension_markdown__migrated_golden_master_examples__image__001: +08_04_37__gitlab_internal_extension_markdown__migrated_golden_master_examples__inline_code__001: spec_example_position: 733 source_specification: gitlab -08_04_37__gitlab_internal_extension_markdown__migrated_golden_master_examples__inline_code__001: +08_04_38__gitlab_internal_extension_markdown__migrated_golden_master_examples__inline_diff__001: spec_example_position: 734 source_specification: gitlab -08_04_38__gitlab_internal_extension_markdown__migrated_golden_master_examples__inline_diff__001: +08_04_39__gitlab_internal_extension_markdown__migrated_golden_master_examples__label__001: spec_example_position: 735 source_specification: gitlab -08_04_39__gitlab_internal_extension_markdown__migrated_golden_master_examples__label__001: +08_04_40__gitlab_internal_extension_markdown__migrated_golden_master_examples__link__001: spec_example_position: 736 source_specification: gitlab -08_04_40__gitlab_internal_extension_markdown__migrated_golden_master_examples__link__001: +08_04_41__gitlab_internal_extension_markdown__migrated_golden_master_examples__math__001: spec_example_position: 737 source_specification: gitlab -08_04_41__gitlab_internal_extension_markdown__migrated_golden_master_examples__math__001: +08_04_42__gitlab_internal_extension_markdown__migrated_golden_master_examples__ordered_list__001: spec_example_position: 738 source_specification: gitlab -08_04_42__gitlab_internal_extension_markdown__migrated_golden_master_examples__ordered_list__001: +08_04_43__gitlab_internal_extension_markdown__migrated_golden_master_examples__ordered_list_with_start_order__001: spec_example_position: 739 source_specification: gitlab -08_04_43__gitlab_internal_extension_markdown__migrated_golden_master_examples__ordered_list_with_start_order__001: +08_04_44__gitlab_internal_extension_markdown__migrated_golden_master_examples__ordered_task_list__001: spec_example_position: 740 source_specification: gitlab -08_04_44__gitlab_internal_extension_markdown__migrated_golden_master_examples__ordered_task_list__001: +08_04_45__gitlab_internal_extension_markdown__migrated_golden_master_examples__ordered_task_list_with_order__001: spec_example_position: 741 source_specification: gitlab -08_04_45__gitlab_internal_extension_markdown__migrated_golden_master_examples__ordered_task_list_with_order__001: +08_04_46__gitlab_internal_extension_markdown__migrated_golden_master_examples__reference_for_project_wiki__001: spec_example_position: 742 source_specification: gitlab -08_04_46__gitlab_internal_extension_markdown__migrated_golden_master_examples__reference_for_project_wiki__001: +08_04_47__gitlab_internal_extension_markdown__migrated_golden_master_examples__strike__001: spec_example_position: 743 source_specification: gitlab -08_04_47__gitlab_internal_extension_markdown__migrated_golden_master_examples__strike__001: +08_04_48__gitlab_internal_extension_markdown__migrated_golden_master_examples__table__001: spec_example_position: 744 source_specification: gitlab -08_04_48__gitlab_internal_extension_markdown__migrated_golden_master_examples__table__001: +08_04_49__gitlab_internal_extension_markdown__migrated_golden_master_examples__table_of_contents__001: spec_example_position: 745 source_specification: gitlab -08_04_49__gitlab_internal_extension_markdown__migrated_golden_master_examples__table_of_contents__001: +08_04_50__gitlab_internal_extension_markdown__migrated_golden_master_examples__task_list__001: spec_example_position: 746 source_specification: gitlab -08_04_50__gitlab_internal_extension_markdown__migrated_golden_master_examples__task_list__001: +08_04_51__gitlab_internal_extension_markdown__migrated_golden_master_examples__video__001: spec_example_position: 747 source_specification: gitlab -08_04_51__gitlab_internal_extension_markdown__migrated_golden_master_examples__video__001: +08_04_52__gitlab_internal_extension_markdown__migrated_golden_master_examples__word_break__001: spec_example_position: 748 source_specification: gitlab -08_04_52__gitlab_internal_extension_markdown__migrated_golden_master_examples__word_break__001: +08_05_00__gitlab_internal_extension_markdown__image_attributes__001: spec_example_position: 749 source_specification: gitlab -08_05_00__gitlab_internal_extension_markdown__image_attributes__001: +08_05_00__gitlab_internal_extension_markdown__image_attributes__002: spec_example_position: 750 source_specification: gitlab -08_05_00__gitlab_internal_extension_markdown__image_attributes__002: +08_05_00__gitlab_internal_extension_markdown__image_attributes__003: spec_example_position: 751 source_specification: gitlab -08_05_00__gitlab_internal_extension_markdown__image_attributes__003: +08_05_00__gitlab_internal_extension_markdown__image_attributes__004: spec_example_position: 752 source_specification: gitlab -08_05_00__gitlab_internal_extension_markdown__image_attributes__004: +08_05_00__gitlab_internal_extension_markdown__image_attributes__005: spec_example_position: 753 source_specification: gitlab -08_05_00__gitlab_internal_extension_markdown__image_attributes__005: +08_06_00__gitlab_internal_extension_markdown__footnotes__001: spec_example_position: 754 source_specification: gitlab diff --git a/glfm_specification/output_example_snapshots/html.yml b/glfm_specification/output_example_snapshots/html.yml index f82e9d18150..cd134f1965c 100644 --- a/glfm_specification/output_example_snapshots/html.yml +++ b/glfm_specification/output_example_snapshots/html.yml @@ -423,7 +423,7 @@ canonical: | <p>## foo</p> static: |- - <p data-sourcepos="1:1-1:28" dir="auto"><span>#</span># foo</p> + <p data-sourcepos="1:1-1:28" dir="auto"><span data-escaped-char>#</span># foo</p> wysiwyg: |- <p>## foo</p> 04_02_00__leaf_blocks__atx_headings__005: @@ -534,11 +534,11 @@ <h1>foo #</h1> static: |- <h3 data-sourcepos="1:1-1:33" dir="auto"> - <a id="user-content-foo-" class="anchor" href="#foo-" aria-hidden="true"></a>foo <span>#</span>##</h3> + <a id="user-content-foo-" class="anchor" href="#foo-" aria-hidden="true"></a>foo <span data-escaped-char>#</span>##</h3> <h2 data-sourcepos="2:1-2:32" dir="auto"> - <a id="user-content-foo--1" class="anchor" href="#foo--1" aria-hidden="true"></a>foo #<span>#</span>#</h2> + <a id="user-content-foo--1" class="anchor" href="#foo--1" aria-hidden="true"></a>foo #<span data-escaped-char>#</span>#</h2> <h1 data-sourcepos="3:1-3:29" dir="auto"> - <a id="user-content-foo--2" class="anchor" href="#foo--2" aria-hidden="true"></a>foo <span>#</span> + <a id="user-content-foo--2" class="anchor" href="#foo--2" aria-hidden="true"></a>foo <span data-escaped-char>#</span> </h1> wysiwyg: |- <h3>foo ###</h3> @@ -4785,7 +4785,7 @@ canonical: | <p>!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~</p> static: |- - <p data-sourcepos="1:1-1:295" dir="auto"><span>!</span>"<span>#</span><span>$</span><span>%</span><span>&</span>'()*+,-./:;<=>?<span>@</span>[\]<span>^</span><span>_</span>`<span>{</span>|<span>}</span><span>~</span></p> + <p data-sourcepos="1:1-1:295" dir="auto"><span data-escaped-char>!</span>"<span data-escaped-char>#</span><span data-escaped-char>$</span><span data-escaped-char>%</span><span data-escaped-char>&</span>'()*+,-./:;<=>?<span data-escaped-char>@</span>[\]<span data-escaped-char>^</span>_`{|}<span data-escaped-char>~</span></p> wysiwyg: |- <p>!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~</p> 06_02_00__inlines__backslash_escapes__002: @@ -4810,9 +4810,9 @@ `not code` 1. not a list * not a list - <span>#</span> not a heading + <span data-escaped-char>#</span> not a heading [foo]: /url "not a reference" - <span>&</span>ouml; not a character entity</p> + <span data-escaped-char>&</span>ouml; not a character entity</p> wysiwyg: |- <p>*not emphasized* <br/> not a tag @@ -5929,7 +5929,7 @@ canonical: | <p>foo <em>_</em></p> static: |- - <p data-sourcepos="1:1-1:29" dir="auto">foo <em><span>_</span></em></p> + <p data-sourcepos="1:1-1:29" dir="auto">foo <em>_</em></p> wysiwyg: |- <p>foo <em>_</em></p> 06_05_00__inlines__emphasis_and_strong_emphasis__100: @@ -5950,7 +5950,7 @@ canonical: | <p>foo <strong>_</strong></p> static: |- - <p data-sourcepos="1:1-1:31" dir="auto">foo <strong><span>_</span></strong></p> + <p data-sourcepos="1:1-1:31" dir="auto">foo <strong>_</strong></p> wysiwyg: |- <p>foo <strong>_</strong></p> 06_05_00__inlines__emphasis_and_strong_emphasis__103: @@ -6639,7 +6639,7 @@ canonical: | <p>[bar][foo!]</p> static: |- - <p data-sourcepos="1:1-1:33" dir="auto">[bar][foo<span>!</span>]</p> + <p data-sourcepos="1:1-1:33" dir="auto">[bar][foo<span data-escaped-char>!</span>]</p> wysiwyg: |- <p>[bar][foo!]</p> <pre>[foo!]: /url</pre> @@ -7043,7 +7043,7 @@ canonical: | <p>!<a href="/url" title="title">foo</a></p> static: |- - <p data-sourcepos="1:1-1:28" dir="auto"><span>!</span><a href="/url" title="title">foo</a></p> + <p data-sourcepos="1:1-1:28" dir="auto"><span data-escaped-char>!</span><a href="/url" title="title">foo</a></p> wysiwyg: |- <p>!<a target="_blank" rel="noopener noreferrer nofollow" href="/url" title="title">foo</a></p> <pre>[foo]: /url "title"</pre> @@ -7633,40 +7633,7 @@ <p data-sourcepos="1:1-1:19" dir="auto">Multiple spaces</p> wysiwyg: |- <p>Multiple spaces</p> -07_01_00__gitlab_official_specification_markdown__footnotes__001: - canonical: | - <p> - footnote reference tag - <sup> - <a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref> - 1 - </a> - </sup> - </p> - <section data-footnotes> - <ol> - <li id="fn-fortytwo-42"> - <p> - footnote text - <a href="#fnref-fortytwo-42" data-footnote-backref> - </a> - </p> - </li> - </ol> - </section> - static: |- - <p data-sourcepos="1:1-1:34" dir="auto">footnote reference tag <sup class="footnote-ref"><a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref>1</a></sup></p> - <section data-footnotes class="footnotes"> - <ol> - <li id="fn-fortytwo-42"> - <p data-sourcepos="3:14-3:26">footnote text <a href="#fnref-fortytwo-42" data-footnote-backref aria-label="Back to content" class="footnote-backref"><gl-emoji title="leftwards arrow with hook" data-name="leftwards_arrow_with_hook" data-unicode-version="1.1">↩</gl-emoji></a></p> - </li> - </ol> - </section> - wysiwyg: |- - <p>footnote reference tag <sup identifier="fortytwo">fortytwo</sup></p> - <div node="footnoteDefinition(paragraph("footnote text"))" htmlattributes="[object Object]"><p>footnote text</p></div> -07_02_00__gitlab_official_specification_markdown__task_list_items__001: +07_01_00__gitlab_official_specification_markdown__task_list_items__001: canonical: | <ul> <li> @@ -7682,7 +7649,7 @@ </ul> wysiwyg: |- <ul start="1" parens="false" data-type="taskList"><li data-checked="false" data-type="taskItem"><label><input type="checkbox"><span></span></label><div><p>incomplete</p></div></li></ul> -07_02_00__gitlab_official_specification_markdown__task_list_items__002: +07_01_00__gitlab_official_specification_markdown__task_list_items__002: canonical: | <ul> <li> @@ -7698,7 +7665,7 @@ </ul> wysiwyg: |- <ul start="1" parens="false" data-type="taskList"><li data-checked="true" data-type="taskItem"><label><input type="checkbox" checked="checked"><span></span></label><div><p>completed</p></div></li></ul> -07_02_00__gitlab_official_specification_markdown__task_list_items__003: +07_01_00__gitlab_official_specification_markdown__task_list_items__003: canonical: | <ul> <li> @@ -7715,7 +7682,7 @@ <task-button></task-button><input type="checkbox" class="task-list-item-checkbox" data-inapplicable disabled> <s>inapplicable</s> </li> </ul> -07_02_00__gitlab_official_specification_markdown__task_list_items__004: +07_01_00__gitlab_official_specification_markdown__task_list_items__004: canonical: | <ul> <li> @@ -7738,7 +7705,7 @@ <p data-sourcepos="3:3-3:20">text in loose list</p> </li> </ul> -07_03_00__gitlab_official_specification_markdown__front_matter__001: +07_02_00__gitlab_official_specification_markdown__front_matter__001: canonical: | <pre> <code> @@ -7752,7 +7719,7 @@ </div> wysiwyg: |- <pre language="yaml" class="content-editor-code-block undefined code highlight" isfrontmatter="true"><code>title: YAML front matter</code></pre> -07_03_00__gitlab_official_specification_markdown__front_matter__002: +07_02_00__gitlab_official_specification_markdown__front_matter__002: canonical: | <pre> <code> @@ -7766,7 +7733,7 @@ </div> wysiwyg: |- <pre language="toml" class="content-editor-code-block undefined code highlight" isfrontmatter="true"><code>title: TOML front matter</code></pre> -07_03_00__gitlab_official_specification_markdown__front_matter__003: +07_02_00__gitlab_official_specification_markdown__front_matter__003: canonical: | <pre> <code> @@ -7786,7 +7753,7 @@ <pre language="json" class="content-editor-code-block undefined code highlight" isfrontmatter="true"><code>{ "title": "JSON front matter" }</code></pre> -07_03_00__gitlab_official_specification_markdown__front_matter__004: +07_02_00__gitlab_official_specification_markdown__front_matter__004: canonical: | <p>text</p> <hr> @@ -7800,7 +7767,7 @@ <p>text</p> <hr> <h2>title: YAML front matter</h2> -07_03_00__gitlab_official_specification_markdown__front_matter__005: +07_02_00__gitlab_official_specification_markdown__front_matter__005: canonical: | <hr> <h2>title: YAML front matter</h2> @@ -7811,7 +7778,7 @@ wysiwyg: |- <hr> <h2>title: YAML front matter</h2> -07_04_00__gitlab_official_specification_markdown__table_of_contents__001: +07_03_00__gitlab_official_specification_markdown__table_of_contents__001: canonical: | <nav> <ul> @@ -7835,7 +7802,7 @@ <div class="table-of-contents gl-border-1 gl-border-solid gl-text-center gl-border-gray-100 gl-mb-5">Table of contents</div> <h1>Heading 1</h1> <h2>Heading 2</h2> -07_04_00__gitlab_official_specification_markdown__table_of_contents__002: +07_03_00__gitlab_official_specification_markdown__table_of_contents__002: canonical: | <nav> <ul> @@ -7859,7 +7826,7 @@ <div class="table-of-contents gl-border-1 gl-border-solid gl-text-center gl-border-gray-100 gl-mb-5">Table of contents</div> <h1>Heading 1</h1> <h2>Heading 2</h2> -07_04_00__gitlab_official_specification_markdown__table_of_contents__003: +07_03_00__gitlab_official_specification_markdown__table_of_contents__003: canonical: | <p>[[<em>TOC</em>]]text</p> <p>text[TOC]</p> @@ -7873,7 +7840,7 @@ text</p> <p>text [TOC]</p> -07_04_00__gitlab_official_specification_markdown__table_of_contents__004: +07_03_00__gitlab_official_specification_markdown__table_of_contents__004: canonical: | <nav> <ul> @@ -7907,14 +7874,14 @@ canonical: | <p><video src="video.m4v" title="video title"></video></p> static: |- - <p data-sourcepos="1:1-1:33" dir="auto"><span class="media-container video-container"><video src="video.m4v" controls="true" data-setup="{}" data-title="video title" width="400" preload="metadata"></video><a href="video.m4v" target="_blank" rel="noopener noreferrer" title="Download 'video title'">video title</a></span></p> + <p data-sourcepos="1:1-1:33" dir="auto"><span class="media-container video-container"><video src="video.m4v" controls="true" data-setup="{}" data-title="video title" preload="metadata" width="400"></video><a href="video.m4v" target="_blank" rel="noopener noreferrer" title="Download 'video title'">video title</a></span></p> wysiwyg: |- <p><span class="media-container video-container"><video src="video.m4v" controls="true" data-setup="{}" data-title="video"></video><a href="video.m4v">video</a></span></p> 08_02_00__gitlab_internal_extension_markdown__video__002: canonical: | <p><video src="video.mov" title="video title"></video></p> static: |- - <p data-sourcepos="3:1-3:15" dir="auto"><span class="media-container video-container"><video src="video.mov" controls="true" data-setup="{}" data-title="video title" width="400" preload="metadata"></video><a href="video.mov" target="_blank" rel="noopener noreferrer" title="Download 'video title'">video title</a></span></p> + <p data-sourcepos="3:1-3:15" dir="auto"><span class="media-container video-container"><video src="video.mov" controls="true" data-setup="{}" data-title="video title" preload="metadata" width="400"></video><a href="video.mov" target="_blank" rel="noopener noreferrer" title="Download 'video title'">video title</a></span></p> wysiwyg: |- <pre>[video]: video.mov "video title"</pre> <p><span class="media-container video-container"><video src="video.mov" controls="true" data-setup="{}" data-title="video"></video><a href="video.mov">video</a></span></p> @@ -8008,10 +7975,10 @@ static: |- <ul data-sourcepos="1:1-3:0" dir="auto"> <li data-sourcepos="1:1-1:43"><span class="media-container audio-container"><audio src="https://gitlab.com/1.mp3" controls="true" data-setup="{}" data-title="Sample Audio"></audio><a href="https://gitlab.com/1.mp3" target="_blank" rel="nofollow noreferrer noopener" title="Download 'Sample Audio'">Sample Audio</a></span></li> - <li data-sourcepos="2:1-3:0"><span class="media-container video-container"><video src="https://gitlab.com/2.mp4" controls="true" data-setup="{}" data-title="Sample Video" width="400" preload="metadata"></video><a href="https://gitlab.com/2.mp4" target="_blank" rel="nofollow noreferrer noopener" title="Download 'Sample Video'">Sample Video</a></span></li> + <li data-sourcepos="2:1-3:0"><span class="media-container video-container"><video src="https://gitlab.com/2.mp4" controls="true" data-setup="{}" data-title="Sample Video" preload="metadata" width="400"></video><a href="https://gitlab.com/2.mp4" target="_blank" rel="nofollow noreferrer noopener" title="Download 'Sample Video'">Sample Video</a></span></li> </ul> <ol data-sourcepos="4:1-6:0" dir="auto"> - <li data-sourcepos="4:1-4:44"><span class="media-container video-container"><video src="https://gitlab.com/1.mp4" controls="true" data-setup="{}" data-title="Sample Video" width="400" preload="metadata"></video><a href="https://gitlab.com/1.mp4" target="_blank" rel="nofollow noreferrer noopener" title="Download 'Sample Video'">Sample Video</a></span></li> + <li data-sourcepos="4:1-4:44"><span class="media-container video-container"><video src="https://gitlab.com/1.mp4" controls="true" data-setup="{}" data-title="Sample Video" preload="metadata" width="400"></video><a href="https://gitlab.com/1.mp4" target="_blank" rel="nofollow noreferrer noopener" title="Download 'Sample Video'">Sample Video</a></span></li> <li data-sourcepos="5:1-6:0"><span class="media-container audio-container"><audio src="https://gitlab.com/2.mp3" controls="true" data-setup="{}" data-title="Sample Audio"></audio><a href="https://gitlab.com/2.mp3" target="_blank" rel="nofollow noreferrer noopener" title="Download 'Sample Audio'">Sample Audio</a></span></li> </ol> <ul data-sourcepos="7:1-9:47" class="task-list" dir="auto"> @@ -8022,7 +7989,7 @@ <task-button></task-button><input type="checkbox" class="task-list-item-checkbox" checked disabled> <span class="media-container audio-container"><audio src="https://gitlab.com/2.mp3" controls="true" data-setup="{}" data-title="Sample Audio"></audio><a href="https://gitlab.com/2.mp3" target="_blank" rel="nofollow noreferrer noopener" title="Download 'Sample Audio'">Sample Audio</a></span> </li> <li data-sourcepos="9:1-9:47" class="task-list-item"> - <task-button></task-button><input type="checkbox" class="task-list-item-checkbox" checked disabled> <span class="media-container video-container"><video src="https://gitlab.com/3.mp4" controls="true" data-setup="{}" data-title="Sample Video" width="400" preload="metadata"></video><a href="https://gitlab.com/3.mp4" target="_blank" rel="nofollow noreferrer noopener" title="Download 'Sample Video'">Sample Video</a></span> + <task-button></task-button><input type="checkbox" class="task-list-item-checkbox" checked disabled> <span class="media-container video-container"><video src="https://gitlab.com/3.mp4" controls="true" data-setup="{}" data-title="Sample Video" preload="metadata" width="400"></video><a href="https://gitlab.com/3.mp4" target="_blank" rel="nofollow noreferrer noopener" title="Download 'Sample Video'">Sample Video</a></span> </li> </ul> wysiwyg: |- @@ -8615,7 +8582,7 @@ canonical: | TODO: Write canonical HTML for this example static: |- - <p data-sourcepos="1:1-1:46" dir="auto"><span class="media-container video-container"><video src="https://gitlab.com/gitlab.mp4" controls="true" data-setup="{}" data-title="Sample Video" width="400" preload="metadata"></video><a href="https://gitlab.com/gitlab.mp4" target="_blank" rel="nofollow noreferrer noopener" title="Download 'Sample Video'">Sample Video</a></span></p> + <p data-sourcepos="1:1-1:46" dir="auto"><span class="media-container video-container"><video src="https://gitlab.com/gitlab.mp4" controls="true" data-setup="{}" data-title="Sample Video" preload="metadata" width="400"></video><a href="https://gitlab.com/gitlab.mp4" target="_blank" rel="nofollow noreferrer noopener" title="Download 'Sample Video'">Sample Video</a></span></p> wysiwyg: |- <p><span class="media-container video-container"><video src="https://gitlab.com/gitlab.mp4" controls="true" data-setup="{}" data-title="Sample Video"></video><a href="https://gitlab.com/gitlab.mp4">Sample Video</a></span></p> 08_04_52__gitlab_internal_extension_markdown__migrated_golden_master_examples__word_break__001: @@ -8650,3 +8617,36 @@ <p><img src="https://gitlab.com/logo.png"> {width="100" height="100"}</p> static: |- <p data-sourcepos="1:1-1:59" dir="auto"><a class="no-attachment-icon" href="https://gitlab.com/logo.png" target="_blank" rel="nofollow noreferrer noopener"><img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="" decoding="async" class="lazy" data-src="https://gitlab.com/logo.png"></a> {width="100" height="100"}</p> +08_06_00__gitlab_internal_extension_markdown__footnotes__001: + canonical: | + <p> + footnote reference tag + <sup> + <a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref> + 1 + </a> + </sup> + </p> + <section data-footnotes> + <ol> + <li id="fn-fortytwo-42"> + <p> + footnote text + <a href="#fnref-fortytwo-42" data-footnote-backref> + </a> + </p> + </li> + </ol> + </section> + static: |- + <p data-sourcepos="1:1-1:34" dir="auto">footnote reference tag <sup class="footnote-ref"><a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref>1</a></sup></p> + <section data-footnotes class="footnotes"> + <ol> + <li id="fn-fortytwo-42"> + <p data-sourcepos="3:14-3:26">footnote text <a href="#fnref-fortytwo-42" data-footnote-backref aria-label="Back to content" class="footnote-backref"><gl-emoji title="leftwards arrow with hook" data-name="leftwards_arrow_with_hook" data-unicode-version="1.1">↩</gl-emoji></a></p> + </li> + </ol> + </section> + wysiwyg: |- + <p>footnote reference tag <sup identifier="fortytwo">fortytwo</sup></p> + <div node="footnoteDefinition(paragraph("footnote text"))" htmlattributes="[object Object]"><p>footnote text</p></div> diff --git a/glfm_specification/output_example_snapshots/markdown.yml b/glfm_specification/output_example_snapshots/markdown.yml index c5145803088..bb41e676002 100644 --- a/glfm_specification/output_example_snapshots/markdown.yml +++ b/glfm_specification/output_example_snapshots/markdown.yml @@ -2189,63 +2189,59 @@ Foo χρῆν 06_15_00__inlines__textual_content__003: | Multiple spaces -07_01_00__gitlab_official_specification_markdown__footnotes__001: | - footnote reference tag [^fortytwo] - - [^fortytwo]: footnote text -07_02_00__gitlab_official_specification_markdown__task_list_items__001: | +07_01_00__gitlab_official_specification_markdown__task_list_items__001: | - [ ] incomplete -07_02_00__gitlab_official_specification_markdown__task_list_items__002: | +07_01_00__gitlab_official_specification_markdown__task_list_items__002: | - [x] completed -07_02_00__gitlab_official_specification_markdown__task_list_items__003: | +07_01_00__gitlab_official_specification_markdown__task_list_items__003: | - [~] inapplicable -07_02_00__gitlab_official_specification_markdown__task_list_items__004: | +07_01_00__gitlab_official_specification_markdown__task_list_items__004: | - [~] inapplicable text in loose list -07_03_00__gitlab_official_specification_markdown__front_matter__001: | +07_02_00__gitlab_official_specification_markdown__front_matter__001: | --- title: YAML front matter --- -07_03_00__gitlab_official_specification_markdown__front_matter__002: | +07_02_00__gitlab_official_specification_markdown__front_matter__002: | +++ title: TOML front matter +++ -07_03_00__gitlab_official_specification_markdown__front_matter__003: | +07_02_00__gitlab_official_specification_markdown__front_matter__003: | ;;; { "title": "JSON front matter" } ;;; -07_03_00__gitlab_official_specification_markdown__front_matter__004: | +07_02_00__gitlab_official_specification_markdown__front_matter__004: | text --- title: YAML front matter --- -07_03_00__gitlab_official_specification_markdown__front_matter__005: |2 +07_02_00__gitlab_official_specification_markdown__front_matter__005: |2 --- title: YAML front matter --- -07_04_00__gitlab_official_specification_markdown__table_of_contents__001: | +07_03_00__gitlab_official_specification_markdown__table_of_contents__001: | [TOC] # Heading 1 ## Heading 2 -07_04_00__gitlab_official_specification_markdown__table_of_contents__002: | +07_03_00__gitlab_official_specification_markdown__table_of_contents__002: | [[_TOC_]] # Heading 1 ## Heading 2 -07_04_00__gitlab_official_specification_markdown__table_of_contents__003: | +07_03_00__gitlab_official_specification_markdown__table_of_contents__003: | [[_TOC_]] text text [TOC] -07_04_00__gitlab_official_specification_markdown__table_of_contents__004: |2 +07_03_00__gitlab_official_specification_markdown__table_of_contents__004: |2 [[_TOC_]] # Heading 1 @@ -2557,3 +2553,7 @@ ![](https://gitlab.com/logo.png){ width="100" height="100" } 08_05_00__gitlab_internal_extension_markdown__image_attributes__005: | ![](https://gitlab.com/logo.png) {width="100" height="100"} +08_06_00__gitlab_internal_extension_markdown__footnotes__001: | + footnote reference tag [^fortytwo] + + [^fortytwo]: footnote text diff --git a/glfm_specification/output_example_snapshots/prosemirror_json.yml b/glfm_specification/output_example_snapshots/prosemirror_json.yml index f6110185348..2ea0c8a6720 100644 --- a/glfm_specification/output_example_snapshots/prosemirror_json.yml +++ b/glfm_specification/output_example_snapshots/prosemirror_json.yml @@ -20698,47 +20698,7 @@ } ] } -07_01_00__gitlab_official_specification_markdown__footnotes__001: |- - { - "type": "doc", - "content": [ - { - "type": "paragraph", - "content": [ - { - "type": "text", - "text": "footnote reference tag " - }, - { - "type": "footnoteReference", - "attrs": { - "identifier": "fortytwo", - "label": "fortytwo" - } - } - ] - }, - { - "type": "footnoteDefinition", - "attrs": { - "identifier": "fortytwo", - "label": "fortytwo" - }, - "content": [ - { - "type": "paragraph", - "content": [ - { - "type": "text", - "text": "footnote text" - } - ] - } - ] - } - ] - } -07_02_00__gitlab_official_specification_markdown__task_list_items__001: |- +07_01_00__gitlab_official_specification_markdown__task_list_items__001: |- { "type": "doc", "content": [ @@ -20771,7 +20731,7 @@ } ] } -07_02_00__gitlab_official_specification_markdown__task_list_items__002: |- +07_01_00__gitlab_official_specification_markdown__task_list_items__002: |- { "type": "doc", "content": [ @@ -20804,7 +20764,7 @@ } ] } -07_03_00__gitlab_official_specification_markdown__front_matter__001: |- +07_02_00__gitlab_official_specification_markdown__front_matter__001: |- { "type": "doc", "content": [ @@ -20825,7 +20785,7 @@ } ] } -07_03_00__gitlab_official_specification_markdown__front_matter__002: |- +07_02_00__gitlab_official_specification_markdown__front_matter__002: |- { "type": "doc", "content": [ @@ -20846,7 +20806,7 @@ } ] } -07_03_00__gitlab_official_specification_markdown__front_matter__003: |- +07_02_00__gitlab_official_specification_markdown__front_matter__003: |- { "type": "doc", "content": [ @@ -20867,7 +20827,7 @@ } ] } -07_03_00__gitlab_official_specification_markdown__front_matter__004: |- +07_02_00__gitlab_official_specification_markdown__front_matter__004: |- { "type": "doc", "content": [ @@ -20897,7 +20857,7 @@ } ] } -07_03_00__gitlab_official_specification_markdown__front_matter__005: |- +07_02_00__gitlab_official_specification_markdown__front_matter__005: |- { "type": "doc", "content": [ @@ -20918,7 +20878,7 @@ } ] } -07_04_00__gitlab_official_specification_markdown__table_of_contents__001: |- +07_03_00__gitlab_official_specification_markdown__table_of_contents__001: |- { "type": "doc", "content": [ @@ -20951,7 +20911,7 @@ } ] } -07_04_00__gitlab_official_specification_markdown__table_of_contents__002: |- +07_03_00__gitlab_official_specification_markdown__table_of_contents__002: |- { "type": "doc", "content": [ @@ -20984,7 +20944,7 @@ } ] } -07_04_00__gitlab_official_specification_markdown__table_of_contents__003: |- +07_03_00__gitlab_official_specification_markdown__table_of_contents__003: |- { "type": "doc", "content": [ @@ -21021,7 +20981,7 @@ } ] } -07_04_00__gitlab_official_specification_markdown__table_of_contents__004: |- +07_03_00__gitlab_official_specification_markdown__table_of_contents__004: |- { "type": "doc", "content": [ @@ -23581,3 +23541,43 @@ } ] } +08_06_00__gitlab_internal_extension_markdown__footnotes__001: |- + { + "type": "doc", + "content": [ + { + "type": "paragraph", + "content": [ + { + "type": "text", + "text": "footnote reference tag " + }, + { + "type": "footnoteReference", + "attrs": { + "identifier": "fortytwo", + "label": "fortytwo" + } + } + ] + }, + { + "type": "footnoteDefinition", + "attrs": { + "identifier": "fortytwo", + "label": "fortytwo" + }, + "content": [ + { + "type": "paragraph", + "content": [ + { + "type": "text", + "text": "footnote text" + } + ] + } + ] + } + ] + } diff --git a/glfm_specification/output_example_snapshots/snapshot_spec.html b/glfm_specification/output_example_snapshots/snapshot_spec.html index 415ad1d0b11..96131037648 100644 --- a/glfm_specification/output_example_snapshots/snapshot_spec.html +++ b/glfm_specification/output_example_snapshots/snapshot_spec.html @@ -296,7 +296,6 @@ </li> <li> <a href="#gitlab-official-specification-markdown">GitLab Official Specification Markdown</a><ul> -<li><a href="#footnotes">Footnotes</a></li> <li><a href="#task-list-items">Task list items</a></li> <li><a href="#front-matter">Front matter</a></li> <li><a href="#table-of-contents">Table of contents</a></li> @@ -336,7 +335,7 @@ <li><a href="#emoji">emoji</a></li> <li><a href="#emphasis">emphasis</a></li> <li><a href="#figure">figure</a></li> -<li><a href="#footnotes-1">footnotes</a></li> +<li><a href="#footnotes">footnotes</a></li> <li><a href="#frontmatter_json">frontmatter_json</a></li> <li><a href="#frontmatter_toml">frontmatter_toml</a></li> <li><a href="#frontmatter_yaml">frontmatter_yaml</a></li> @@ -364,6 +363,7 @@ </ul> </li> <li><a href="#image-attributes">Image Attributes</a></li> +<li><a href="#footnotes-1">Footnotes</a></li> </ul> </li> </ul> @@ -12156,66 +12156,30 @@ be parsed as plain textual content.</p> </div> <h1 data-sourcepos="13634:1-13634:40" dir="auto"> <a id="user-content-gitlab-official-specification-markdown" class="anchor" href="#gitlab-official-specification-markdown" aria-hidden="true"></a>GitLab Official Specification Markdown</h1> -<p data-sourcepos="13636:1-13639:104" dir="auto">Currently, only some of the GitLab-specific markdown features are -listed in this section. We may eventually add all -GitLab-specific features currently listed as supported in the +<p data-sourcepos="13636:1-13638:104" dir="auto">Note: This specification is a work in progress. Only some of the official GLFM extensions +are defined. We will continue to add any additional ones found in the <a href="https://docs.gitlab.com/ee/user/markdown.html" rel="nofollow noreferrer noopener" target="_blank">user-facing documentation for GitLab Flavored Markdown</a>.</p> -<p data-sourcepos="13641:1-13642:69" dir="auto">There is currently only this single top-level heading, but the +<p data-sourcepos="13640:1-13641:69" dir="auto">There is currently only this single top-level heading, but the examples may be split into multiple top-level headings in the future.</p> -<h2 data-sourcepos="13644:1-13644:12" dir="auto"> -<a id="user-content-footnotes" class="anchor" href="#footnotes" aria-hidden="true"></a>Footnotes</h2> -<p data-sourcepos="13646:1-13647:143" dir="auto">See -<a href="https://docs.gitlab.com/ee/user/markdown.html#footnotes" rel="nofollow noreferrer noopener" target="_blank">the footnotes section of the user-facing documentation for GitLab Flavored Markdown</a>.</p> -<div> -<div><a href="#example-674">Example 674</a></div> -<div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13652:1-13656:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">footnote reference tag [^fortytwo]</span> -<span id="LC2" class="line" lang="plaintext"></span> -<span id="LC3" class="line" lang="plaintext">[^fortytwo]: footnote text</span></code></pre> -<copy-code></copy-code> -</div> -<div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13658:1-13678:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p></span> -<span id="LC2" class="line" lang="plaintext">footnote reference tag</span> -<span id="LC3" class="line" lang="plaintext"><sup></span> -<span id="LC4" class="line" lang="plaintext"><a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref></span> -<span id="LC5" class="line" lang="plaintext">1</span> -<span id="LC6" class="line" lang="plaintext"></a></span> -<span id="LC7" class="line" lang="plaintext"></sup></span> -<span id="LC8" class="line" lang="plaintext"></p></span> -<span id="LC9" class="line" lang="plaintext"><section data-footnotes></span> -<span id="LC10" class="line" lang="plaintext"><ol></span> -<span id="LC11" class="line" lang="plaintext"><li id="fn-fortytwo-42"></span> -<span id="LC12" class="line" lang="plaintext"><p></span> -<span id="LC13" class="line" lang="plaintext">footnote text</span> -<span id="LC14" class="line" lang="plaintext"><a href="#fnref-fortytwo-42" data-footnote-backref></span> -<span id="LC15" class="line" lang="plaintext"></a></span> -<span id="LC16" class="line" lang="plaintext"></p></span> -<span id="LC17" class="line" lang="plaintext"></li></span> -<span id="LC18" class="line" lang="plaintext"></ol></span> -<span id="LC19" class="line" lang="plaintext"></section></span></code></pre> -<copy-code></copy-code> -</div> -</div> -<h2 data-sourcepos="13681:1-13681:18" dir="auto"> +<h2 data-sourcepos="13643:1-13643:18" dir="auto"> <a id="user-content-task-list-items" class="anchor" href="#task-list-items" aria-hidden="true"></a>Task list items</h2> -<p data-sourcepos="13683:1-13684:117" dir="auto">See +<p data-sourcepos="13645:1-13646:117" dir="auto">See <a href="https://docs.gitlab.com/ee/user/markdown.html#task-lists" rel="nofollow noreferrer noopener" target="_blank">Task lists</a> in the GitLab Flavored Markdown documentation.</p> -<p data-sourcepos="13686:1-13689:39" dir="auto">Task list items (checkboxes) are defined as a GitHub Flavored Markdown extension in a section above. +<p data-sourcepos="13648:1-13651:39" dir="auto">Task list items (checkboxes) are defined as a GitHub Flavored Markdown extension in a section above. GitLab extends the behavior of task list items to support additional features. Some of these features are in-progress, and should not yet be considered part of the official GitLab Flavored Markdown specification.</p> -<p data-sourcepos="13691:1-13691:85" dir="auto">Some of the behavior of task list items is implemented as client-side JavaScript/CSS.</p> -<p data-sourcepos="13693:1-13693:80" dir="auto">The following are some basic examples; more examples may be added in the future.</p> -<p data-sourcepos="13695:1-13695:16" dir="auto">Incomplete task:</p> +<p data-sourcepos="13653:1-13653:85" dir="auto">Some of the behavior of task list items is implemented as client-side JavaScript/CSS.</p> +<p data-sourcepos="13655:1-13655:80" dir="auto">The following are some basic examples; more examples may be added in the future.</p> +<p data-sourcepos="13657:1-13657:16" dir="auto">Incomplete task:</p> <div> -<div><a href="#example-675">Example 675</a></div> +<div><a href="#example-674">Example 674</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13700:1-13702:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [ ] incomplete</span></code></pre> +<pre data-sourcepos="13662:1-13664:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [ ] incomplete</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13704:1-13712:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> +<pre data-sourcepos="13666:1-13674:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> <span id="LC2" class="line" lang="plaintext"><li></span> <span id="LC3" class="line" lang="plaintext"><task-button/></span> <span id="LC4" class="line" lang="plaintext"><input type="checkbox" disabled/></span> @@ -12225,15 +12189,15 @@ GitLab Flavored Markdown specification.</p> <copy-code></copy-code> </div> </div> -<p data-sourcepos="13715:1-13715:15" dir="auto">Completed task:</p> +<p data-sourcepos="13677:1-13677:15" dir="auto">Completed task:</p> <div> -<div><a href="#example-676">Example 676</a></div> +<div><a href="#example-675">Example 675</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13720:1-13722:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [x] completed</span></code></pre> +<pre data-sourcepos="13682:1-13684:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [x] completed</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13724:1-13732:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> +<pre data-sourcepos="13686:1-13694:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> <span id="LC2" class="line" lang="plaintext"><li></span> <span id="LC3" class="line" lang="plaintext"><task-button/></span> <span id="LC4" class="line" lang="plaintext"><input type="checkbox" checked disabled/></span> @@ -12243,15 +12207,15 @@ GitLab Flavored Markdown specification.</p> <copy-code></copy-code> </div> </div> -<p data-sourcepos="13735:1-13735:18" dir="auto">Inapplicable task:</p> +<p data-sourcepos="13697:1-13697:18" dir="auto">Inapplicable task:</p> <div> -<div><a href="#example-677">Example 677</a></div> +<div><a href="#example-676">Example 676</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13740:1-13742:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [~] inapplicable</span></code></pre> +<pre data-sourcepos="13702:1-13704:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [~] inapplicable</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13744:1-13754:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> +<pre data-sourcepos="13706:1-13716:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> <span id="LC2" class="line" lang="plaintext"><li></span> <span id="LC3" class="line" lang="plaintext"><task-button/></span> <span id="LC4" class="line" lang="plaintext"><input type="checkbox" data-inapplicable disabled></span> @@ -12263,18 +12227,18 @@ GitLab Flavored Markdown specification.</p> <copy-code></copy-code> </div> </div> -<p data-sourcepos="13757:1-13758:50" dir="auto">Inapplicable task in a "loose" list. Note that the <code><del></code> tag is not applied to the +<p data-sourcepos="13719:1-13720:50" dir="auto">Inapplicable task in a "loose" list. Note that the <code><del></code> tag is not applied to the loose text; it has strikethrough applied with CSS.</p> <div> -<div><a href="#example-678">Example 678</a></div> +<div><a href="#example-677">Example 677</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13763:1-13767:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [~] inapplicable</span> +<pre data-sourcepos="13725:1-13729:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [~] inapplicable</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext"> text in loose list</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13769:1-13784:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> +<pre data-sourcepos="13731:1-13746:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> <span id="LC2" class="line" lang="plaintext"><li></span> <span id="LC3" class="line" lang="plaintext"><p></span> <span id="LC4" class="line" lang="plaintext"><task-button/></span> @@ -12291,23 +12255,23 @@ loose text; it has strikethrough applied with CSS.</p> <copy-code></copy-code> </div> </div> -<h2 data-sourcepos="13787:1-13787:15" dir="auto"> +<h2 data-sourcepos="13749:1-13749:15" dir="auto"> <a id="user-content-front-matter" class="anchor" href="#front-matter" aria-hidden="true"></a>Front matter</h2> -<p data-sourcepos="13789:1-13790:121" dir="auto">See +<p data-sourcepos="13751:1-13752:121" dir="auto">See <a href="https://docs.gitlab.com/ee/user/markdown.html#front-matter" rel="nofollow noreferrer noopener" target="_blank">Front matter</a> in the GitLab Flavored Markdown documentation.</p> -<p data-sourcepos="13792:1-13793:95" dir="auto">Front matter is metadata included at the beginning of a Markdown document, preceding the content. +<p data-sourcepos="13754:1-13755:95" dir="auto">Front matter is metadata included at the beginning of a Markdown document, preceding the content. This data can be used by static site generators like Jekyll, Hugo, and many other applications.</p> -<p data-sourcepos="13795:1-13795:18" dir="auto">YAML front matter:</p> +<p data-sourcepos="13757:1-13757:18" dir="auto">YAML front matter:</p> <div> -<div><a href="#example-679">Example 679</a></div> +<div><a href="#example-678">Example 678</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13800:1-13804:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">---</span> +<pre data-sourcepos="13762:1-13766:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">---</span> <span id="LC2" class="line" lang="plaintext">title: YAML front matter</span> <span id="LC3" class="line" lang="plaintext">---</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13806:1-13812:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> +<pre data-sourcepos="13768:1-13774:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> <span id="LC2" class="line" lang="plaintext"><code></span> <span id="LC3" class="line" lang="plaintext">title: YAML front matter</span> <span id="LC4" class="line" lang="plaintext"></code></span> @@ -12315,17 +12279,17 @@ This data can be used by static site generators like Jekyll, Hugo, and many othe <copy-code></copy-code> </div> </div> -<p data-sourcepos="13815:1-13815:18" dir="auto">TOML front matter:</p> +<p data-sourcepos="13777:1-13777:18" dir="auto">TOML front matter:</p> <div> -<div><a href="#example-680">Example 680</a></div> +<div><a href="#example-679">Example 679</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13820:1-13824:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">+++</span> +<pre data-sourcepos="13782:1-13786:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">+++</span> <span id="LC2" class="line" lang="plaintext">title: TOML front matter</span> <span id="LC3" class="line" lang="plaintext">+++</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13826:1-13832:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> +<pre data-sourcepos="13788:1-13794:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> <span id="LC2" class="line" lang="plaintext"><code></span> <span id="LC3" class="line" lang="plaintext">title: TOML front matter</span> <span id="LC4" class="line" lang="plaintext"></code></span> @@ -12333,11 +12297,11 @@ This data can be used by static site generators like Jekyll, Hugo, and many othe <copy-code></copy-code> </div> </div> -<p data-sourcepos="13835:1-13835:18" dir="auto">JSON front matter:</p> +<p data-sourcepos="13797:1-13797:18" dir="auto">JSON front matter:</p> <div> -<div><a href="#example-681">Example 681</a></div> +<div><a href="#example-680">Example 680</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13840:1-13846:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">;;;</span> +<pre data-sourcepos="13802:1-13808:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">;;;</span> <span id="LC2" class="line" lang="plaintext">{</span> <span id="LC3" class="line" lang="plaintext"> "title": "JSON front matter"</span> <span id="LC4" class="line" lang="plaintext">}</span> @@ -12345,7 +12309,7 @@ This data can be used by static site generators like Jekyll, Hugo, and many othe <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13848:1-13856:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> +<pre data-sourcepos="13810:1-13818:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> <span id="LC2" class="line" lang="plaintext"><code></span> <span id="LC3" class="line" lang="plaintext">{</span> <span id="LC4" class="line" lang="plaintext"> "title": "JSON front matter"</span> @@ -12355,11 +12319,11 @@ This data can be used by static site generators like Jekyll, Hugo, and many othe <copy-code></copy-code> </div> </div> -<p data-sourcepos="13859:1-13859:66" dir="auto">Front matter blocks should be inserted at the top of the document:</p> +<p data-sourcepos="13821:1-13821:66" dir="auto">Front matter blocks should be inserted at the top of the document:</p> <div> -<div><a href="#example-682">Example 682</a></div> +<div><a href="#example-681">Example 681</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13864:1-13870:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">text</span> +<pre data-sourcepos="13826:1-13832:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">text</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext">---</span> <span id="LC4" class="line" lang="plaintext">title: YAML front matter</span> @@ -12367,43 +12331,43 @@ This data can be used by static site generators like Jekyll, Hugo, and many othe <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13872:1-13876:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>text</p></span> +<pre data-sourcepos="13834:1-13838:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>text</p></span> <span id="LC2" class="line" lang="plaintext"><hr></span> <span id="LC3" class="line" lang="plaintext"><h2>title: YAML front matter</h2></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="13879:1-13879:74" dir="auto">Front matter block delimiters shouldn’t be preceded by space characters:</p> +<p data-sourcepos="13841:1-13841:74" dir="auto">Front matter block delimiters shouldn’t be preceded by space characters:</p> <div> -<div><a href="#example-683">Example 683</a></div> +<div><a href="#example-682">Example 682</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13884:1-13888:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"> ---</span> +<pre data-sourcepos="13846:1-13850:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"> ---</span> <span id="LC2" class="line" lang="plaintext">title: YAML front matter</span> <span id="LC3" class="line" lang="plaintext">---</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13890:1-13893:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><hr></span> +<pre data-sourcepos="13852:1-13855:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><hr></span> <span id="LC2" class="line" lang="plaintext"><h2>title: YAML front matter</h2></span></code></pre> <copy-code></copy-code> </div> </div> -<h2 data-sourcepos="13896:1-13896:20" dir="auto"> +<h2 data-sourcepos="13858:1-13858:20" dir="auto"> <a id="user-content-table-of-contents" class="anchor" href="#table-of-contents" aria-hidden="true"></a>Table of contents</h2> -<p data-sourcepos="13898:1-13900:46" dir="auto">See +<p data-sourcepos="13860:1-13862:46" dir="auto">See <a href="https://docs.gitlab.com/ee/user/markdown.html#table-of-contents" rel="nofollow noreferrer noopener" target="_blank">table of contents</a> in the GitLab Flavored Markdown documentation.</p> -<p data-sourcepos="13902:1-13906:23" dir="auto">NOTE: Because of this bug (<a href="https://gitlab.com/gitlab-org/gitlab/-/issues/359077" rel="nofollow noreferrer noopener" target="_blank">https://gitlab.com/gitlab-org/gitlab/-/issues/359077</a>), +<p data-sourcepos="13864:1-13868:23" dir="auto">NOTE: Because of this bug (<a href="https://gitlab.com/gitlab-org/gitlab/-/issues/359077" rel="nofollow noreferrer noopener" target="_blank">https://gitlab.com/gitlab-org/gitlab/-/issues/359077</a>), we cannot actually include the <code>TOC</code> tag with single brackets in backticks in this Markdown document, otherwise it would render a table of contents inline right here. So, it's been switched to <code>[</code> + <code>TOC</code> + <code>]</code> instead. This can be reverted once that bug is fixed.</p> -<p data-sourcepos="13908:1-13909:76" dir="auto">A table of contents is an unordered list that links to subheadings in the document. +<p data-sourcepos="13870:1-13871:76" dir="auto">A table of contents is an unordered list that links to subheadings in the document. Add either the <code>[[_TOC_]]</code> tag or the <code>[</code> + <code>TOC</code> + <code>]</code> tag on its own line.</p> <div> -<div><a href="#example-684">Example 684</a></div> +<div><a href="#example-683">Example 683</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13914:1-13920:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[TOC]</span> +<pre data-sourcepos="13876:1-13882:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[TOC]</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext"># Heading 1</span> <span id="LC4" class="line" lang="plaintext"></span> @@ -12411,7 +12375,7 @@ Add either the <code>[[_TOC_]]</code> tag or the <code>[</code> + <code>TOC</cod <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13922:1-13933:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> +<pre data-sourcepos="13884:1-13895:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> <span id="LC2" class="line" lang="plaintext"> <ul></span> <span id="LC3" class="line" lang="plaintext"> <li><a href="#heading-1">Heading 1</a></li></span> <span id="LC4" class="line" lang="plaintext"> <ul></span> @@ -12425,9 +12389,9 @@ Add either the <code>[[_TOC_]]</code> tag or the <code>[</code> + <code>TOC</cod </div> </div> <div> -<div><a href="#example-685">Example 685</a></div> +<div><a href="#example-684">Example 684</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13939:1-13945:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[[_TOC_]]</span> +<pre data-sourcepos="13901:1-13907:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[[_TOC_]]</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext"># Heading 1</span> <span id="LC4" class="line" lang="plaintext"></span> @@ -12435,7 +12399,7 @@ Add either the <code>[[_TOC_]]</code> tag or the <code>[</code> + <code>TOC</cod <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13947:1-13958:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> +<pre data-sourcepos="13909:1-13920:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> <span id="LC2" class="line" lang="plaintext"> <ul></span> <span id="LC3" class="line" lang="plaintext"> <li><a href="#heading-1">Heading 1</a></li></span> <span id="LC4" class="line" lang="plaintext"> <ul></span> @@ -12448,12 +12412,12 @@ Add either the <code>[[_TOC_]]</code> tag or the <code>[</code> + <code>TOC</cod <copy-code></copy-code> </div> </div> -<p data-sourcepos="13961:1-13962:5" dir="auto">A table of contents is a block element. It should preceded and followed by a blank +<p data-sourcepos="13923:1-13924:5" dir="auto">A table of contents is a block element. It should preceded and followed by a blank line.</p> <div> -<div><a href="#example-686">Example 686</a></div> +<div><a href="#example-685">Example 685</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13967:1-13973:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[[_TOC_]]</span> +<pre data-sourcepos="13929:1-13935:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[[_TOC_]]</span> <span id="LC2" class="line" lang="plaintext">text</span> <span id="LC3" class="line" lang="plaintext"></span> <span id="LC4" class="line" lang="plaintext">text</span> @@ -12461,22 +12425,22 @@ line.</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13975:1-13978:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>[[<em>TOC</em>]]text</p></span> +<pre data-sourcepos="13937:1-13940:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>[[<em>TOC</em>]]text</p></span> <span id="LC2" class="line" lang="plaintext"><p>text[TOC]</p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="13981:1-13981:60" dir="auto">A table of contents can be indented with up to three spaces.</p> +<p data-sourcepos="13943:1-13943:60" dir="auto">A table of contents can be indented with up to three spaces.</p> <div> -<div><a href="#example-687">Example 687</a></div> +<div><a href="#example-686">Example 686</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13986:1-13990:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"> [[_TOC_]]</span> +<pre data-sourcepos="13948:1-13952:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"> [[_TOC_]]</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext"># Heading 1</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="13992:1-13999:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> +<pre data-sourcepos="13954:1-13961:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> <span id="LC2" class="line" lang="plaintext"> <ul></span> <span id="LC3" class="line" lang="plaintext"> <li><a href="#heading-1">Heading 1</a></li></span> <span id="LC4" class="line" lang="plaintext"> </ul></span> @@ -12485,265 +12449,265 @@ line.</p> <copy-code></copy-code> </div> </div> -<h1 data-sourcepos="14002:1-14002:36" dir="auto"> +<h1 data-sourcepos="13964:1-13964:36" dir="auto"> <a id="user-content-gitlab-internal-extension-markdown" class="anchor" href="#gitlab-internal-extension-markdown" aria-hidden="true"></a>GitLab Internal Extension Markdown</h1> -<h2 data-sourcepos="14004:1-14004:8" dir="auto"> +<h2 data-sourcepos="13966:1-13966:8" dir="auto"> <a id="user-content-audio" class="anchor" href="#audio" aria-hidden="true"></a>Audio</h2> -<p data-sourcepos="14006:1-14007:107" dir="auto">See +<p data-sourcepos="13968:1-13969:107" dir="auto">See <a href="https://docs.gitlab.com/ee/user/markdown.html#audio" rel="nofollow noreferrer noopener" target="_blank">audio</a> in the GitLab Flavored Markdown documentation.</p> -<p data-sourcepos="14009:1-14011:63" dir="auto">GLFM renders image elements as an audio player as long as the resource’s file extension is +<p data-sourcepos="13971:1-13973:63" dir="auto">GLFM renders image elements as an audio player as long as the resource’s file extension is one of the following supported audio extensions <code>.mp3</code>, <code>.oga</code>, <code>.ogg</code>, <code>.spx</code>, and <code>.wav</code>. Audio ignore the alternative text part of an image declaration.</p> <div> -<div><a href="#example-688">Example 688</a></div> +<div><a href="#example-687">Example 687</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14016:1-14018:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![audio](audio.oga "audio title")</span></code></pre> +<pre data-sourcepos="13978:1-13980:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![audio](audio.oga "audio title")</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14020:1-14022:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><audio src="audio.oga" title="audio title"></audio></p></span></code></pre> +<pre data-sourcepos="13982:1-13984:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><audio src="audio.oga" title="audio title"></audio></p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="14025:1-14025:41" dir="auto">Reference definitions work audio as well:</p> +<p data-sourcepos="13987:1-13987:41" dir="auto">Reference definitions work audio as well:</p> <div> -<div><a href="#example-689">Example 689</a></div> +<div><a href="#example-688">Example 688</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14030:1-14034:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[audio]: audio.oga "audio title"</span> +<pre data-sourcepos="13992:1-13996:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[audio]: audio.oga "audio title"</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext">![audio][audio]</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14036:1-14038:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><audio src="audio.oga" title="audio title"></audio></p></span></code></pre> +<pre data-sourcepos="13998:1-14000:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><audio src="audio.oga" title="audio title"></audio></p></span></code></pre> <copy-code></copy-code> </div> </div> -<h2 data-sourcepos="14041:1-14041:8" dir="auto"> +<h2 data-sourcepos="14003:1-14003:8" dir="auto"> <a id="user-content-video" class="anchor" href="#video" aria-hidden="true"></a>Video</h2> -<p data-sourcepos="14043:1-14044:109" dir="auto">See +<p data-sourcepos="14005:1-14006:109" dir="auto">See <a href="https://docs.gitlab.com/ee/user/markdown.html#videos" rel="nofollow noreferrer noopener" target="_blank">videos</a> in the GitLab Flavored Markdown documentation.</p> -<p data-sourcepos="14046:1-14048:64" dir="auto">GLFM renders image elements as a video player as long as the resource’s file extension is +<p data-sourcepos="14008:1-14010:64" dir="auto">GLFM renders image elements as a video player as long as the resource’s file extension is one of the following supported video extensions <code>.mp4</code>, <code>.m4v</code>, <code>.mov</code>, <code>.webm</code>, and <code>.ogv</code>. Videos ignore the alternative text part of an image declaration.</p> <div> -<div><a href="#example-690">Example 690</a></div> +<div><a href="#example-689">Example 689</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14054:1-14056:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![video](video.m4v "video title")</span></code></pre> +<pre data-sourcepos="14016:1-14018:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![video](video.m4v "video title")</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14058:1-14060:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><video src="video.m4v" title="video title"></video></p></span></code></pre> +<pre data-sourcepos="14020:1-14022:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><video src="video.m4v" title="video title"></video></p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="14063:1-14063:41" dir="auto">Reference definitions work video as well:</p> +<p data-sourcepos="14025:1-14025:41" dir="auto">Reference definitions work video as well:</p> <div> -<div><a href="#example-691">Example 691</a></div> +<div><a href="#example-690">Example 690</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14068:1-14072:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[video]: video.mov "video title"</span> +<pre data-sourcepos="14030:1-14034:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[video]: video.mov "video title"</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext">![video][video]</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14074:1-14076:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><video src="video.mov" title="video title"></video></p></span></code></pre> +<pre data-sourcepos="14036:1-14038:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><video src="video.mov" title="video title"></video></p></span></code></pre> <copy-code></copy-code> </div> </div> -<h2 data-sourcepos="14079:1-14079:41" dir="auto"> +<h2 data-sourcepos="14041:1-14041:41" dir="auto"> <a id="user-content-markdown-preview-api-request-overrides" class="anchor" href="#markdown-preview-api-request-overrides" aria-hidden="true"></a>Markdown Preview API Request Overrides</h2> -<p data-sourcepos="14081:1-14083:42" dir="auto">This section contains examples of all controllers which use <code>PreviewMarkdown</code> module +<p data-sourcepos="14043:1-14045:42" dir="auto">This section contains examples of all controllers which use <code>PreviewMarkdown</code> module and use different <code>markdown_context_params</code>. They exercise the various <code>preview_markdown</code> endpoints via <code>glfm_example_metadata.yml</code>.</p> -<p data-sourcepos="14086:1-14086:75" dir="auto"><code>preview_markdown</code> exercising <code>groups</code> API endpoint and <code>UploadLinkFilter</code>:</p> +<p data-sourcepos="14048:1-14048:75" dir="auto"><code>preview_markdown</code> exercising <code>groups</code> API endpoint and <code>UploadLinkFilter</code>:</p> <div> -<div><a href="#example-692">Example 692</a></div> +<div><a href="#example-691">Example 691</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14091:1-14093:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[groups-test-file](/uploads/groups-test-file)</span></code></pre> +<pre data-sourcepos="14053:1-14055:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[groups-test-file](/uploads/groups-test-file)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14095:1-14097:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><a href="groups-test-file">groups-test-file</a></p></span></code></pre> +<pre data-sourcepos="14057:1-14059:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><a href="groups-test-file">groups-test-file</a></p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="14100:1-14100:81" dir="auto"><code>preview_markdown</code> exercising <code>projects</code> API endpoint and <code>RepositoryLinkFilter</code>:</p> +<p data-sourcepos="14062:1-14062:81" dir="auto"><code>preview_markdown</code> exercising <code>projects</code> API endpoint and <code>RepositoryLinkFilter</code>:</p> <div> -<div><a href="#example-693">Example 693</a></div> +<div><a href="#example-692">Example 692</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14105:1-14107:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[projects-test-file](projects-test-file)</span></code></pre> +<pre data-sourcepos="14067:1-14069:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[projects-test-file](projects-test-file)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14109:1-14111:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><a href="projects-test-file">projects-test-file</a></p></span></code></pre> +<pre data-sourcepos="14071:1-14073:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><a href="projects-test-file">projects-test-file</a></p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="14114:1-14114:83" dir="auto"><code>preview_markdown</code> exercising <code>projects</code> API endpoint and <code>SnippetReferenceFilter</code>:</p> +<p data-sourcepos="14076:1-14076:83" dir="auto"><code>preview_markdown</code> exercising <code>projects</code> API endpoint and <code>SnippetReferenceFilter</code>:</p> <div> -<div><a href="#example-694">Example 694</a></div> +<div><a href="#example-693">Example 693</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14119:1-14121:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">This project snippet ID reference IS filtered: $88888</span></code></pre> +<pre data-sourcepos="14081:1-14083:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">This project snippet ID reference IS filtered: $88888</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14123:1-14125:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>This project snippet ID reference IS filtered: $88888</p></span></code></pre> +<pre data-sourcepos="14085:1-14087:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>This project snippet ID reference IS filtered: $88888</p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="14128:1-14131:50" dir="auto"><code>preview_markdown</code> exercising personal (non-project) <code>snippets</code> API endpoint. This is +<p data-sourcepos="14090:1-14093:50" dir="auto"><code>preview_markdown</code> exercising personal (non-project) <code>snippets</code> API endpoint. This is only used by the comment field on personal snippets. It has no unique custom markdown extension behavior, and specifically does not render snippet references via <code>SnippetReferenceFilter</code>, even if the ID is valid.</p> <div> -<div><a href="#example-695">Example 695</a></div> +<div><a href="#example-694">Example 694</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14136:1-14138:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">This personal snippet ID reference is not filtered: $99999</span></code></pre> +<pre data-sourcepos="14098:1-14100:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">This personal snippet ID reference is not filtered: $99999</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14140:1-14142:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>This personal snippet ID reference is not filtered: $99999</p></span></code></pre> +<pre data-sourcepos="14102:1-14104:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>This personal snippet ID reference is not filtered: $99999</p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="14145:1-14145:80" dir="auto"><code>preview_markdown</code> exercising project <code>wikis</code> API endpoint and <code>WikiLinkFilter</code>:</p> +<p data-sourcepos="14107:1-14107:80" dir="auto"><code>preview_markdown</code> exercising project <code>wikis</code> API endpoint and <code>WikiLinkFilter</code>:</p> <div> -<div><a href="#example-696">Example 696</a></div> +<div><a href="#example-695">Example 695</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14150:1-14152:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[project-wikis-test-file](project-wikis-test-file)</span></code></pre> +<pre data-sourcepos="14112:1-14114:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[project-wikis-test-file](project-wikis-test-file)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14154:1-14156:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><a href="project-wikis-test-file">project-wikis-test-file</a></p></span></code></pre> +<pre data-sourcepos="14116:1-14118:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><a href="project-wikis-test-file">project-wikis-test-file</a></p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="14159:1-14160:63" dir="auto"><code>preview_markdown</code> exercising group <code>wikis</code> API endpoint and <code>WikiLinkFilter</code>. This example +<p data-sourcepos="14121:1-14122:63" dir="auto"><code>preview_markdown</code> exercising group <code>wikis</code> API endpoint and <code>WikiLinkFilter</code>. This example also requires an EE license enabling the <code>group_wikis</code> feature:</p> <div> -<div><a href="#example-697">Example 697</a></div> +<div><a href="#example-696">Example 696</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14165:1-14167:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[group-wikis-test-file](group-wikis-test-file)</span></code></pre> +<pre data-sourcepos="14127:1-14129:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[group-wikis-test-file](group-wikis-test-file)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14169:1-14171:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><a href="group-wikis-test-file">group-wikis-test-file</a></p></span></code></pre> +<pre data-sourcepos="14131:1-14133:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><a href="group-wikis-test-file">group-wikis-test-file</a></p></span></code></pre> <copy-code></copy-code> </div> </div> -<h2 data-sourcepos="14174:1-14174:34" dir="auto"> +<h2 data-sourcepos="14136:1-14136:34" dir="auto"> <a id="user-content-migrated-golden-master-examples" class="anchor" href="#migrated-golden-master-examples" aria-hidden="true"></a>Migrated golden master examples</h2> -<h3 data-sourcepos="14176:1-14176:30" dir="auto"> +<h3 data-sourcepos="14138:1-14138:30" dir="auto"> <a id="user-content-attachment_image_for_group" class="anchor" href="#attachment_image_for_group" aria-hidden="true"></a>attachment_image_for_group</h3> <div> -<div><a href="#example-698">Example 698</a></div> +<div><a href="#example-697">Example 697</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14181:1-14183:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![test-file](/uploads/aa45a38ec2cfe97433281b10bbff042c/test-file.png)</span></code></pre> +<pre data-sourcepos="14143:1-14145:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![test-file](/uploads/aa45a38ec2cfe97433281b10bbff042c/test-file.png)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14185:1-14187:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14147:1-14149:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14190:1-14190:32" dir="auto"> +<h3 data-sourcepos="14152:1-14152:32" dir="auto"> <a id="user-content-attachment_image_for_project" class="anchor" href="#attachment_image_for_project" aria-hidden="true"></a>attachment_image_for_project</h3> <div> -<div><a href="#example-699">Example 699</a></div> +<div><a href="#example-698">Example 698</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14195:1-14197:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![test-file](/uploads/aa45a38ec2cfe97433281b10bbff042c/test-file.png)</span></code></pre> +<pre data-sourcepos="14157:1-14159:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![test-file](/uploads/aa45a38ec2cfe97433281b10bbff042c/test-file.png)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14199:1-14201:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14161:1-14163:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14204:1-14204:37" dir="auto"> +<h3 data-sourcepos="14166:1-14166:37" dir="auto"> <a id="user-content-attachment_image_for_project_wiki" class="anchor" href="#attachment_image_for_project_wiki" aria-hidden="true"></a>attachment_image_for_project_wiki</h3> <div> -<div><a href="#example-700">Example 700</a></div> +<div><a href="#example-699">Example 699</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14209:1-14211:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![test-file](test-file.png)</span></code></pre> +<pre data-sourcepos="14171:1-14173:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![test-file](test-file.png)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14213:1-14215:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14175:1-14177:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14218:1-14218:29" dir="auto"> +<h3 data-sourcepos="14180:1-14180:29" dir="auto"> <a id="user-content-attachment_link_for_group" class="anchor" href="#attachment_link_for_group" aria-hidden="true"></a>attachment_link_for_group</h3> <div> -<div><a href="#example-701">Example 701</a></div> +<div><a href="#example-700">Example 700</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14223:1-14225:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[test-file](/uploads/aa45a38ec2cfe97433281b10bbff042c/test-file.zip)</span></code></pre> +<pre data-sourcepos="14185:1-14187:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[test-file](/uploads/aa45a38ec2cfe97433281b10bbff042c/test-file.zip)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14227:1-14229:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14189:1-14191:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14232:1-14232:31" dir="auto"> +<h3 data-sourcepos="14194:1-14194:31" dir="auto"> <a id="user-content-attachment_link_for_project" class="anchor" href="#attachment_link_for_project" aria-hidden="true"></a>attachment_link_for_project</h3> <div> -<div><a href="#example-702">Example 702</a></div> +<div><a href="#example-701">Example 701</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14237:1-14239:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[test-file](/uploads/aa45a38ec2cfe97433281b10bbff042c/test-file.zip)</span></code></pre> +<pre data-sourcepos="14199:1-14201:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[test-file](/uploads/aa45a38ec2cfe97433281b10bbff042c/test-file.zip)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14241:1-14243:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14203:1-14205:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14246:1-14246:36" dir="auto"> +<h3 data-sourcepos="14208:1-14208:36" dir="auto"> <a id="user-content-attachment_link_for_project_wiki" class="anchor" href="#attachment_link_for_project_wiki" aria-hidden="true"></a>attachment_link_for_project_wiki</h3> <div> -<div><a href="#example-703">Example 703</a></div> +<div><a href="#example-702">Example 702</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14251:1-14253:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[test-file](test-file.zip)</span></code></pre> +<pre data-sourcepos="14213:1-14215:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[test-file](test-file.zip)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14255:1-14257:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14217:1-14219:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14260:1-14260:34" dir="auto"> +<h3 data-sourcepos="14222:1-14222:34" dir="auto"> <a id="user-content-attachment_link_for_group_wiki" class="anchor" href="#attachment_link_for_group_wiki" aria-hidden="true"></a>attachment_link_for_group_wiki</h3> <div> -<div><a href="#example-704">Example 704</a></div> +<div><a href="#example-703">Example 703</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14265:1-14267:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[test-file](test-file.zip)</span></code></pre> +<pre data-sourcepos="14227:1-14229:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[test-file](test-file.zip)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14269:1-14271:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14231:1-14233:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14274:1-14274:9" dir="auto"> +<h3 data-sourcepos="14236:1-14236:9" dir="auto"> <a id="user-content-audio-1" class="anchor" href="#audio-1" aria-hidden="true"></a>audio</h3> <div> -<div><a href="#example-705">Example 705</a></div> +<div><a href="#example-704">Example 704</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14279:1-14281:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![Sample Audio](https://gitlab.com/gitlab.mp3)</span></code></pre> +<pre data-sourcepos="14241:1-14243:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![Sample Audio](https://gitlab.com/gitlab.mp3)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14283:1-14285:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14245:1-14247:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14288:1-14288:28" dir="auto"> +<h3 data-sourcepos="14250:1-14250:28" dir="auto"> <a id="user-content-audio_and_video_in_lists" class="anchor" href="#audio_and_video_in_lists" aria-hidden="true"></a>audio_and_video_in_lists</h3> <div> -<div><a href="#example-706">Example 706</a></div> +<div><a href="#example-705">Example 705</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14293:1-14303:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">* ![Sample Audio](https://gitlab.com/1.mp3)</span> +<pre data-sourcepos="14255:1-14265:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">* ![Sample Audio](https://gitlab.com/1.mp3)</span> <span id="LC2" class="line" lang="plaintext">* ![Sample Video](https://gitlab.com/2.mp4)</span> <span id="LC3" class="line" lang="plaintext"></span> <span id="LC4" class="line" lang="plaintext">1. ![Sample Video](https://gitlab.com/1.mp4)</span> @@ -12755,134 +12719,134 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14305:1-14307:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14267:1-14269:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14310:1-14310:14" dir="auto"> +<h3 data-sourcepos="14272:1-14272:14" dir="auto"> <a id="user-content-blockquote" class="anchor" href="#blockquote" aria-hidden="true"></a>blockquote</h3> <div> -<div><a href="#example-707">Example 707</a></div> +<div><a href="#example-706">Example 706</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14315:1-14319:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">> This is a blockquote</span> +<pre data-sourcepos="14277:1-14281:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">> This is a blockquote</span> <span id="LC2" class="line" lang="plaintext">></span> <span id="LC3" class="line" lang="plaintext">> This is another one</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14321:1-14323:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14283:1-14285:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14326:1-14326:8" dir="auto"> +<h3 data-sourcepos="14288:1-14288:8" dir="auto"> <a id="user-content-bold" class="anchor" href="#bold" aria-hidden="true"></a>bold</h3> <div> -<div><a href="#example-708">Example 708</a></div> +<div><a href="#example-707">Example 707</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14331:1-14333:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">**bold**</span></code></pre> +<pre data-sourcepos="14293:1-14295:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">**bold**</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14335:1-14337:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14297:1-14299:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14340:1-14340:23" dir="auto"> +<h3 data-sourcepos="14302:1-14302:23" dir="auto"> <a id="user-content-bullet_list_style_1" class="anchor" href="#bullet_list_style_1" aria-hidden="true"></a>bullet_list_style_1</h3> <div> -<div><a href="#example-709">Example 709</a></div> +<div><a href="#example-708">Example 708</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14345:1-14349:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">* list item 1</span> +<pre data-sourcepos="14307:1-14311:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">* list item 1</span> <span id="LC2" class="line" lang="plaintext">* list item 2</span> <span id="LC3" class="line" lang="plaintext"> * embedded list item 3</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14351:1-14353:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14313:1-14315:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14356:1-14356:23" dir="auto"> +<h3 data-sourcepos="14318:1-14318:23" dir="auto"> <a id="user-content-bullet_list_style_2" class="anchor" href="#bullet_list_style_2" aria-hidden="true"></a>bullet_list_style_2</h3> <div> -<div><a href="#example-710">Example 710</a></div> +<div><a href="#example-709">Example 709</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14361:1-14365:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- list item 1</span> +<pre data-sourcepos="14323:1-14327:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- list item 1</span> <span id="LC2" class="line" lang="plaintext">- list item 2</span> <span id="LC3" class="line" lang="plaintext"> * embedded list item 3</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14367:1-14369:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14329:1-14331:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14372:1-14372:23" dir="auto"> +<h3 data-sourcepos="14334:1-14334:23" dir="auto"> <a id="user-content-bullet_list_style_3" class="anchor" href="#bullet_list_style_3" aria-hidden="true"></a>bullet_list_style_3</h3> <div> -<div><a href="#example-711">Example 711</a></div> +<div><a href="#example-710">Example 710</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14377:1-14381:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">+ list item 1</span> +<pre data-sourcepos="14339:1-14343:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">+ list item 1</span> <span id="LC2" class="line" lang="plaintext">+ list item 2</span> <span id="LC3" class="line" lang="plaintext"> - embedded list item 3</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14383:1-14385:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14345:1-14347:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14388:1-14388:25" dir="auto"> +<h3 data-sourcepos="14350:1-14350:25" dir="auto"> <a id="user-content-code_block_javascript" class="anchor" href="#code_block_javascript" aria-hidden="true"></a>code_block_javascript</h3> <div> -<div><a href="#example-712">Example 712</a></div> +<div><a href="#example-711">Example 711</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14393:1-14397:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```javascript</span> +<pre data-sourcepos="14355:1-14359:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```javascript</span> <span id="LC2" class="line" lang="plaintext"> console.log('hello world')</span> <span id="LC3" class="line" lang="plaintext">```</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14399:1-14401:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14361:1-14363:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14404:1-14404:24" dir="auto"> +<h3 data-sourcepos="14366:1-14366:24" dir="auto"> <a id="user-content-code_block_plaintext" class="anchor" href="#code_block_plaintext" aria-hidden="true"></a>code_block_plaintext</h3> <div> -<div><a href="#example-713">Example 713</a></div> +<div><a href="#example-712">Example 712</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14409:1-14413:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```</span> +<pre data-sourcepos="14371:1-14375:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```</span> <span id="LC2" class="line" lang="plaintext"> plaintext</span> <span id="LC3" class="line" lang="plaintext">```</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14415:1-14417:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14377:1-14379:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14420:1-14420:22" dir="auto"> +<h3 data-sourcepos="14382:1-14382:22" dir="auto"> <a id="user-content-code_block_unknown" class="anchor" href="#code_block_unknown" aria-hidden="true"></a>code_block_unknown</h3> <div> -<div><a href="#example-714">Example 714</a></div> +<div><a href="#example-713">Example 713</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14425:1-14429:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```foobar</span> +<pre data-sourcepos="14387:1-14391:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```foobar</span> <span id="LC2" class="line" lang="plaintext"> custom_language = >> this <<</span> <span id="LC3" class="line" lang="plaintext">```</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14431:1-14433:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14393:1-14395:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14436:1-14436:15" dir="auto"> +<h3 data-sourcepos="14398:1-14398:15" dir="auto"> <a id="user-content-color_chips" class="anchor" href="#color_chips" aria-hidden="true"></a>color_chips</h3> <div> -<div><a href="#example-715">Example 715</a></div> +<div><a href="#example-714">Example 714</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14441:1-14451:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- `#F00`</span> +<pre data-sourcepos="14403:1-14413:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- `#F00`</span> <span id="LC2" class="line" lang="plaintext">- `#F00A`</span> <span id="LC3" class="line" lang="plaintext">- `#FF0000`</span> <span id="LC4" class="line" lang="plaintext">- `#FF0000AA`</span> @@ -12894,16 +12858,16 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14453:1-14455:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14415:1-14417:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14458:1-14458:20" dir="auto"> +<h3 data-sourcepos="14420:1-14420:20" dir="auto"> <a id="user-content-description_list" class="anchor" href="#description_list" aria-hidden="true"></a>description_list</h3> <div> -<div><a href="#example-716">Example 716</a></div> +<div><a href="#example-715">Example 715</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14463:1-14480:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><dl></span> +<pre data-sourcepos="14425:1-14442:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><dl></span> <span id="LC2" class="line" lang="plaintext"><dt>Frog</dt></span> <span id="LC3" class="line" lang="plaintext"><dd>Wet green thing</dd></span> <span id="LC4" class="line" lang="plaintext"><dt>Rabbit</dt></span> @@ -12922,16 +12886,16 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14482:1-14484:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14444:1-14446:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14487:1-14487:11" dir="auto"> +<h3 data-sourcepos="14449:1-14449:11" dir="auto"> <a id="user-content-details" class="anchor" href="#details" aria-hidden="true"></a>details</h3> <div> -<div><a href="#example-717">Example 717</a></div> +<div><a href="#example-716">Example 716</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14492:1-14500:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><details></span> +<pre data-sourcepos="14454:1-14462:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><details></span> <span id="LC2" class="line" lang="plaintext"><summary>This is the visible summary of the collapsible section</summary></span> <span id="LC3" class="line" lang="plaintext"></span> <span id="LC4" class="line" lang="plaintext">1. collapsed markdown</span> @@ -12941,16 +12905,16 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14502:1-14504:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14464:1-14466:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14507:1-14507:25" dir="auto"> +<h3 data-sourcepos="14469:1-14469:25" dir="auto"> <a id="user-content-diagram_kroki_nomnoml" class="anchor" href="#diagram_kroki_nomnoml" aria-hidden="true"></a>diagram_kroki_nomnoml</h3> <div> -<div><a href="#example-718">Example 718</a></div> +<div><a href="#example-717">Example 717</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14512:1-14524:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```nomnoml</span> +<pre data-sourcepos="14474:1-14486:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```nomnoml</span> <span id="LC2" class="line" lang="plaintext"> #stroke: #a86128</span> <span id="LC3" class="line" lang="plaintext"> [<frame>Decorator pattern|</span> <span id="LC4" class="line" lang="plaintext"> [<abstract>Component||+ operation()]</span> @@ -12964,16 +12928,16 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14526:1-14528:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14488:1-14490:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14531:1-14531:20" dir="auto"> +<h3 data-sourcepos="14493:1-14493:20" dir="auto"> <a id="user-content-diagram_plantuml" class="anchor" href="#diagram_plantuml" aria-hidden="true"></a>diagram_plantuml</h3> <div> -<div><a href="#example-719">Example 719</a></div> +<div><a href="#example-718">Example 718</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14536:1-14544:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```plantuml</span> +<pre data-sourcepos="14498:1-14506:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```plantuml</span> <span id="LC2" class="line" lang="plaintext"> Alice -> Bob: Authentication Request</span> <span id="LC3" class="line" lang="plaintext"> Bob --> Alice: Authentication Response</span> <span id="LC4" class="line" lang="plaintext"></span> @@ -12983,31 +12947,31 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14546:1-14548:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14508:1-14510:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14551:1-14551:28" dir="auto"> +<h3 data-sourcepos="14513:1-14513:28" dir="auto"> <a id="user-content-diagram_plantuml_unicode" class="anchor" href="#diagram_plantuml_unicode" aria-hidden="true"></a>diagram_plantuml_unicode</h3> <div> -<div><a href="#example-720">Example 720</a></div> +<div><a href="#example-719">Example 719</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14556:1-14560:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```plantuml</span> +<pre data-sourcepos="14518:1-14522:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">```plantuml</span> <span id="LC2" class="line" lang="plaintext">A -> B : Text with norwegian characters: æøå</span> <span id="LC3" class="line" lang="plaintext">```</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14562:1-14564:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14524:1-14526:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14567:1-14567:7" dir="auto"> +<h3 data-sourcepos="14529:1-14529:7" dir="auto"> <a id="user-content-div" class="anchor" href="#div" aria-hidden="true"></a>div</h3> <div> -<div><a href="#example-721">Example 721</a></div> +<div><a href="#example-720">Example 720</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14572:1-14579:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><div>plain text</div></span> +<pre data-sourcepos="14534:1-14541:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><div>plain text</div></span> <span id="LC2" class="line" lang="plaintext"><div></span> <span id="LC3" class="line" lang="plaintext"></span> <span id="LC4" class="line" lang="plaintext">just a plain ol' div, not much to _expect_!</span> @@ -13016,42 +12980,42 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14581:1-14583:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14543:1-14545:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14586:1-14586:9" dir="auto"> +<h3 data-sourcepos="14548:1-14548:9" dir="auto"> <a id="user-content-emoji" class="anchor" href="#emoji" aria-hidden="true"></a>emoji</h3> <div> -<div><a href="#example-722">Example 722</a></div> +<div><a href="#example-721">Example 721</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14591:1-14593:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">:sparkles: :heart: :100:</span></code></pre> +<pre data-sourcepos="14553:1-14555:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">:sparkles: :heart: :100:</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14595:1-14597:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14557:1-14559:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14600:1-14600:12" dir="auto"> +<h3 data-sourcepos="14562:1-14562:12" dir="auto"> <a id="user-content-emphasis" class="anchor" href="#emphasis" aria-hidden="true"></a>emphasis</h3> <div> -<div><a href="#example-723">Example 723</a></div> +<div><a href="#example-722">Example 722</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14605:1-14607:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">_emphasized text_</span></code></pre> +<pre data-sourcepos="14567:1-14569:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">_emphasized text_</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14609:1-14611:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14571:1-14573:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14614:1-14614:10" dir="auto"> +<h3 data-sourcepos="14576:1-14576:10" dir="auto"> <a id="user-content-figure" class="anchor" href="#figure" aria-hidden="true"></a>figure</h3> <div> -<div><a href="#example-724">Example 724</a></div> +<div><a href="#example-723">Example 723</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14619:1-14636:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><figure></span> +<pre data-sourcepos="14581:1-14598:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><figure></span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext">![Elephant at sunset](elephant-sunset.jpg)</span> <span id="LC4" class="line" lang="plaintext"></span> @@ -13070,16 +13034,16 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14638:1-14640:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14600:1-14602:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14643:1-14643:13" dir="auto"> -<a id="user-content-footnotes-1" class="anchor" href="#footnotes-1" aria-hidden="true"></a>footnotes</h3> +<h3 data-sourcepos="14605:1-14605:13" dir="auto"> +<a id="user-content-footnotes" class="anchor" href="#footnotes" aria-hidden="true"></a>footnotes</h3> <div> -<div><a href="#example-725">Example 725</a></div> +<div><a href="#example-724">Example 724</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14648:1-14656:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">A footnote reference tag looks like this: [^1]</span> +<pre data-sourcepos="14610:1-14618:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">A footnote reference tag looks like this: [^1]</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext">This reference tag is a mix of letters and numbers. [^footnote]</span> <span id="LC4" class="line" lang="plaintext"></span> @@ -13089,16 +13053,16 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14658:1-14660:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14620:1-14622:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14663:1-14663:20" dir="auto"> +<h3 data-sourcepos="14625:1-14625:20" dir="auto"> <a id="user-content-frontmatter_json" class="anchor" href="#frontmatter_json" aria-hidden="true"></a>frontmatter_json</h3> <div> -<div><a href="#example-726">Example 726</a></div> +<div><a href="#example-725">Example 725</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14668:1-14674:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">;;;</span> +<pre data-sourcepos="14630:1-14636:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">;;;</span> <span id="LC2" class="line" lang="plaintext">{</span> <span id="LC3" class="line" lang="plaintext"> "title": "Page title"</span> <span id="LC4" class="line" lang="plaintext">}</span> @@ -13106,60 +13070,60 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14676:1-14678:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14638:1-14640:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14681:1-14681:20" dir="auto"> +<h3 data-sourcepos="14643:1-14643:20" dir="auto"> <a id="user-content-frontmatter_toml" class="anchor" href="#frontmatter_toml" aria-hidden="true"></a>frontmatter_toml</h3> <div> -<div><a href="#example-727">Example 727</a></div> +<div><a href="#example-726">Example 726</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14686:1-14690:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">+++</span> +<pre data-sourcepos="14648:1-14652:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">+++</span> <span id="LC2" class="line" lang="plaintext">title = "Page title"</span> <span id="LC3" class="line" lang="plaintext">+++</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14692:1-14694:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14654:1-14656:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14697:1-14697:20" dir="auto"> +<h3 data-sourcepos="14659:1-14659:20" dir="auto"> <a id="user-content-frontmatter_yaml" class="anchor" href="#frontmatter_yaml" aria-hidden="true"></a>frontmatter_yaml</h3> <div> -<div><a href="#example-728">Example 728</a></div> +<div><a href="#example-727">Example 727</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14702:1-14706:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">---</span> +<pre data-sourcepos="14664:1-14668:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">---</span> <span id="LC2" class="line" lang="plaintext">title: Page title</span> <span id="LC3" class="line" lang="plaintext">---</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14708:1-14710:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14670:1-14672:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14713:1-14713:14" dir="auto"> +<h3 data-sourcepos="14675:1-14675:14" dir="auto"> <a id="user-content-hard_break" class="anchor" href="#hard_break" aria-hidden="true"></a>hard_break</h3> <div> -<div><a href="#example-729">Example 729</a></div> +<div><a href="#example-728">Example 728</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14718:1-14721:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">This is a line after a\</span> +<pre data-sourcepos="14680:1-14683:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">This is a line after a\</span> <span id="LC2" class="line" lang="plaintext">hard break</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14723:1-14725:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14685:1-14687:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14728:1-14728:12" dir="auto"> +<h3 data-sourcepos="14690:1-14690:12" dir="auto"> <a id="user-content-headings" class="anchor" href="#headings" aria-hidden="true"></a>headings</h3> <div> -<div><a href="#example-730">Example 730</a></div> +<div><a href="#example-729">Example 729</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14733:1-14745:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"># Heading 1</span> +<pre data-sourcepos="14695:1-14707:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"># Heading 1</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext">## Heading 2</span> <span id="LC4" class="line" lang="plaintext"></span> @@ -13173,29 +13137,29 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14747:1-14749:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14709:1-14711:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14752:1-14752:19" dir="auto"> +<h3 data-sourcepos="14714:1-14714:19" dir="auto"> <a id="user-content-horizontal_rule" class="anchor" href="#horizontal_rule" aria-hidden="true"></a>horizontal_rule</h3> <div> -<div><a href="#example-731">Example 731</a></div> +<div><a href="#example-730">Example 730</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14757:1-14759:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">---</span></code></pre> +<pre data-sourcepos="14719:1-14721:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">---</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14761:1-14763:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14723:1-14725:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14766:1-14766:14" dir="auto"> +<h3 data-sourcepos="14728:1-14728:14" dir="auto"> <a id="user-content-html_marks" class="anchor" href="#html_marks" aria-hidden="true"></a>html_marks</h3> <div> -<div><a href="#example-732">Example 732</a></div> +<div><a href="#example-731">Example 731</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14771:1-14787:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">* Content editor is ~~great~~<ins>amazing</ins>.</span> +<pre data-sourcepos="14733:1-14749:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">* Content editor is ~~great~~<ins>amazing</ins>.</span> <span id="LC2" class="line" lang="plaintext">* If the changes <abbr title="Looks good to merge">LGTM</abbr>, please <abbr title="Merge when pipeline succeeds">MWPS</abbr>.</span> <span id="LC3" class="line" lang="plaintext">* The English song <q>Oh I do like to be beside the seaside</q> looks like this in Hebrew: <span dir="rtl">אה, אני אוהב להיות ליד חוף הים</span>. In the computer's memory, this is stored as <bdo dir="ltr">אה, אני אוהב להיות ליד חוף הים</bdo>.</span> <span id="LC4" class="line" lang="plaintext">* <cite>The Scream</cite> by Edvard Munch. Painted in 1893.</span> @@ -13213,82 +13177,82 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14789:1-14791:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14751:1-14753:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14794:1-14794:9" dir="auto"> +<h3 data-sourcepos="14756:1-14756:9" dir="auto"> <a id="user-content-image" class="anchor" href="#image" aria-hidden="true"></a>image</h3> <div> -<div><a href="#example-733">Example 733</a></div> +<div><a href="#example-732">Example 732</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14799:1-14801:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![alt text](https://gitlab.com/logo.png)</span></code></pre> +<pre data-sourcepos="14761:1-14763:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![alt text](https://gitlab.com/logo.png)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14803:1-14805:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14765:1-14767:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14808:1-14808:15" dir="auto"> +<h3 data-sourcepos="14770:1-14770:15" dir="auto"> <a id="user-content-inline_code" class="anchor" href="#inline_code" aria-hidden="true"></a>inline_code</h3> <div> -<div><a href="#example-734">Example 734</a></div> +<div><a href="#example-733">Example 733</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14813:1-14815:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">`code`</span></code></pre> +<pre data-sourcepos="14775:1-14777:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">`code`</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14817:1-14819:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14779:1-14781:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14822:1-14822:15" dir="auto"> +<h3 data-sourcepos="14784:1-14784:15" dir="auto"> <a id="user-content-inline_diff" class="anchor" href="#inline_diff" aria-hidden="true"></a>inline_diff</h3> <div> -<div><a href="#example-735">Example 735</a></div> +<div><a href="#example-734">Example 734</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14827:1-14830:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">* {-deleted-}</span> +<pre data-sourcepos="14789:1-14792:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">* {-deleted-}</span> <span id="LC2" class="line" lang="plaintext">* {+added+}</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14832:1-14834:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14794:1-14796:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14837:1-14837:9" dir="auto"> +<h3 data-sourcepos="14799:1-14799:9" dir="auto"> <a id="user-content-label" class="anchor" href="#label" aria-hidden="true"></a>label</h3> <div> -<div><a href="#example-736">Example 736</a></div> +<div><a href="#example-735">Example 735</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14842:1-14844:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">~bug</span></code></pre> +<pre data-sourcepos="14804:1-14806:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">~bug</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14846:1-14848:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14808:1-14810:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14851:1-14851:8" dir="auto"> +<h3 data-sourcepos="14813:1-14813:8" dir="auto"> <a id="user-content-link" class="anchor" href="#link" aria-hidden="true"></a>link</h3> <div> -<div><a href="#example-737">Example 737</a></div> +<div><a href="#example-736">Example 736</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14856:1-14858:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[GitLab](https://gitlab.com)</span></code></pre> +<pre data-sourcepos="14818:1-14820:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[GitLab](https://gitlab.com)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14860:1-14862:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14822:1-14824:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14865:1-14865:8" dir="auto"> +<h3 data-sourcepos="14827:1-14827:8" dir="auto"> <a id="user-content-math" class="anchor" href="#math" aria-hidden="true"></a>math</h3> <div> -<div><a href="#example-738">Example 738</a></div> +<div><a href="#example-737">Example 737</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14870:1-14878:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">This math is inline $`a^2+b^2=c^2`$.</span> +<pre data-sourcepos="14832:1-14840:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">This math is inline $`a^2+b^2=c^2`$.</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext">This is on a separate line:</span> <span id="LC4" class="line" lang="plaintext"></span> @@ -13298,46 +13262,46 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14880:1-14882:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14842:1-14844:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14885:1-14885:16" dir="auto"> +<h3 data-sourcepos="14847:1-14847:16" dir="auto"> <a id="user-content-ordered_list" class="anchor" href="#ordered_list" aria-hidden="true"></a>ordered_list</h3> <div> -<div><a href="#example-739">Example 739</a></div> +<div><a href="#example-738">Example 738</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14890:1-14894:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">1. list item 1</span> +<pre data-sourcepos="14852:1-14856:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">1. list item 1</span> <span id="LC2" class="line" lang="plaintext">2. list item 2</span> <span id="LC3" class="line" lang="plaintext">3. list item 3</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14896:1-14898:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14858:1-14860:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14901:1-14901:33" dir="auto"> +<h3 data-sourcepos="14863:1-14863:33" dir="auto"> <a id="user-content-ordered_list_with_start_order" class="anchor" href="#ordered_list_with_start_order" aria-hidden="true"></a>ordered_list_with_start_order</h3> <div> -<div><a href="#example-740">Example 740</a></div> +<div><a href="#example-739">Example 739</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14906:1-14910:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">134. list item 1</span> +<pre data-sourcepos="14868:1-14872:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">134. list item 1</span> <span id="LC2" class="line" lang="plaintext">135. list item 2</span> <span id="LC3" class="line" lang="plaintext">136. list item 3</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14912:1-14914:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14874:1-14876:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14917:1-14917:21" dir="auto"> +<h3 data-sourcepos="14879:1-14879:21" dir="auto"> <a id="user-content-ordered_task_list" class="anchor" href="#ordered_task_list" aria-hidden="true"></a>ordered_task_list</h3> <div> -<div><a href="#example-741">Example 741</a></div> +<div><a href="#example-740">Example 740</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14922:1-14929:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">1. [x] hello</span> +<pre data-sourcepos="14884:1-14891:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">1. [x] hello</span> <span id="LC2" class="line" lang="plaintext">2. [x] world</span> <span id="LC3" class="line" lang="plaintext">3. [ ] example</span> <span id="LC4" class="line" lang="plaintext"> 1. [ ] of nested</span> @@ -13346,57 +13310,57 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14931:1-14933:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14893:1-14895:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14936:1-14936:32" dir="auto"> +<h3 data-sourcepos="14898:1-14898:32" dir="auto"> <a id="user-content-ordered_task_list_with_order" class="anchor" href="#ordered_task_list_with_order" aria-hidden="true"></a>ordered_task_list_with_order</h3> <div> -<div><a href="#example-742">Example 742</a></div> +<div><a href="#example-741">Example 741</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14941:1-14945:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">4893. [x] hello</span> +<pre data-sourcepos="14903:1-14907:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">4893. [x] hello</span> <span id="LC2" class="line" lang="plaintext">4894. [x] world</span> <span id="LC3" class="line" lang="plaintext">4895. [ ] example</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14947:1-14949:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14909:1-14911:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14952:1-14952:30" dir="auto"> +<h3 data-sourcepos="14914:1-14914:30" dir="auto"> <a id="user-content-reference_for_project_wiki" class="anchor" href="#reference_for_project_wiki" aria-hidden="true"></a>reference_for_project_wiki</h3> <div> -<div><a href="#example-743">Example 743</a></div> +<div><a href="#example-742">Example 742</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14957:1-14959:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">Hi @gfm_user - thank you for reporting this ~"UX bug" (#1) we hope to fix it in %1.1 as part of !1</span></code></pre> +<pre data-sourcepos="14919:1-14921:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">Hi @gfm_user - thank you for reporting this ~"UX bug" (#1) we hope to fix it in %1.1 as part of !1</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14961:1-14963:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14923:1-14925:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14966:1-14966:10" dir="auto"> +<h3 data-sourcepos="14928:1-14928:10" dir="auto"> <a id="user-content-strike" class="anchor" href="#strike" aria-hidden="true"></a>strike</h3> <div> -<div><a href="#example-744">Example 744</a></div> +<div><a href="#example-743">Example 743</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14971:1-14973:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">~~del~~</span></code></pre> +<pre data-sourcepos="14933:1-14935:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">~~del~~</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14975:1-14977:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14937:1-14939:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14980:1-14980:9" dir="auto"> +<h3 data-sourcepos="14942:1-14942:9" dir="auto"> <a id="user-content-table" class="anchor" href="#table" aria-hidden="true"></a>table</h3> <div> -<div><a href="#example-745">Example 745</a></div> +<div><a href="#example-744">Example 744</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14985:1-14992:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">| header | header |</span> +<pre data-sourcepos="14947:1-14954:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">| header | header |</span> <span id="LC2" class="line" lang="plaintext">|--------|--------|</span> <span id="LC3" class="line" lang="plaintext">| `code` | cell with **bold** |</span> <span id="LC4" class="line" lang="plaintext">| ~~strike~~ | cell with _italic_ |</span> @@ -13405,16 +13369,16 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="14994:1-14996:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14956:1-14958:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="14999:1-14999:21" dir="auto"> +<h3 data-sourcepos="14961:1-14961:21" dir="auto"> <a id="user-content-table_of_contents" class="anchor" href="#table_of_contents" aria-hidden="true"></a>table_of_contents</h3> <div> -<div><a href="#example-746">Example 746</a></div> +<div><a href="#example-745">Example 745</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15004:1-15018:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[[_TOC_]]</span> +<pre data-sourcepos="14966:1-14980:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[[_TOC_]]</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext"># Lorem</span> <span id="LC4" class="line" lang="plaintext"></span> @@ -13430,16 +13394,16 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15020:1-15022:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="14982:1-14984:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="15025:1-15025:13" dir="auto"> +<h3 data-sourcepos="14987:1-14987:13" dir="auto"> <a id="user-content-task_list" class="anchor" href="#task_list" aria-hidden="true"></a>task_list</h3> <div> -<div><a href="#example-747">Example 747</a></div> +<div><a href="#example-746">Example 746</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15030:1-15037:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">* [x] hello</span> +<pre data-sourcepos="14992:1-14999:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">* [x] hello</span> <span id="LC2" class="line" lang="plaintext">* [x] world</span> <span id="LC3" class="line" lang="plaintext">* [ ] example</span> <span id="LC4" class="line" lang="plaintext"> * [ ] of nested</span> @@ -13448,101 +13412,136 @@ also requires an EE license enabling the <code>group_wikis</code> feature:</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15039:1-15041:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="15001:1-15003:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="15044:1-15044:9" dir="auto"> +<h3 data-sourcepos="15006:1-15006:9" dir="auto"> <a id="user-content-video-1" class="anchor" href="#video-1" aria-hidden="true"></a>video</h3> <div> -<div><a href="#example-748">Example 748</a></div> +<div><a href="#example-747">Example 747</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15049:1-15051:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![Sample Video](https://gitlab.com/gitlab.mp4)</span></code></pre> +<pre data-sourcepos="15011:1-15013:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![Sample Video](https://gitlab.com/gitlab.mp4)</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15053:1-15055:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="15015:1-15017:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h3 data-sourcepos="15058:1-15058:14" dir="auto"> +<h3 data-sourcepos="15020:1-15020:14" dir="auto"> <a id="user-content-word_break" class="anchor" href="#word_break" aria-hidden="true"></a>word_break</h3> <div> -<div><a href="#example-749">Example 749</a></div> +<div><a href="#example-748">Example 748</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15063:1-15065:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">Fernstraßen<wbr>bau<wbr>privat<wbr>finanzierungs<wbr>gesetz</span></code></pre> +<pre data-sourcepos="15025:1-15027:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">Fernstraßen<wbr>bau<wbr>privat<wbr>finanzierungs<wbr>gesetz</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15067:1-15069:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> +<pre data-sourcepos="15029:1-15031:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">TODO: Write canonical HTML for this example</span></code></pre> <copy-code></copy-code> </div> </div> -<h2 data-sourcepos="15072:1-15072:19" dir="auto"> +<h2 data-sourcepos="15034:1-15034:19" dir="auto"> <a id="user-content-image-attributes" class="anchor" href="#image-attributes" aria-hidden="true"></a>Image Attributes</h2> -<p data-sourcepos="15074:1-15076:46" dir="auto">See +<p data-sourcepos="15036:1-15038:46" dir="auto">See <a href="https://docs.gitlab.com/ee/user/markdown.html#change-the-image-dimensions" rel="nofollow noreferrer noopener" target="_blank">Change the image dimensions</a> in the GitLab Flavored Markdown documentation.</p> -<p data-sourcepos="15078:1-15079:19" dir="auto">The <code>width</code> and <code>height</code> attributes for an image can be specified directly after +<p data-sourcepos="15040:1-15041:19" dir="auto">The <code>width</code> and <code>height</code> attributes for an image can be specified directly after the image markdown.</p> -<p data-sourcepos="15081:1-15083:21" dir="auto">General syntax conforms to the +<p data-sourcepos="15043:1-15045:21" dir="auto">General syntax conforms to the <a href="https://github.com/jgm/commonmark-hs/blob/master/commonmark-extensions/test/attributes.md" rel="nofollow noreferrer noopener" target="_blank">commonmark-hs attribute syntax</a> where it makes sense.</p> <div> +<div><a href="#example-749">Example 749</a></div> +<div class="gl-relative markdown-code-block js-markdown-code"> +<pre data-sourcepos="15050:1-15052:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![](https://gitlab.com/logo.png){width="100" height="100"}</span></code></pre> +<copy-code></copy-code> +</div> +<div class="gl-relative markdown-code-block js-markdown-code"> +<pre data-sourcepos="15054:1-15056:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><img src="https://gitlab.com/logo.png" width="100" height="100"></p></span></code></pre> +<copy-code></copy-code> +</div> +</div> +<p data-sourcepos="15059:1-15059:41" dir="auto"><code>%</code> and <code>px</code> units may also be specified.</p> +<div> <div><a href="#example-750">Example 750</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15088:1-15090:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![](https://gitlab.com/logo.png){width="100" height="100"}</span></code></pre> +<pre data-sourcepos="15064:1-15066:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![](https://gitlab.com/logo.png){width="100%"}</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15092:1-15094:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><img src="https://gitlab.com/logo.png" width="100" height="100"></p></span></code></pre> +<pre data-sourcepos="15068:1-15070:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><img src="https://gitlab.com/logo.png" width="100%"></p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="15097:1-15097:41" dir="auto"><code>%</code> and <code>px</code> units may also be specified.</p> <div> <div><a href="#example-751">Example 751</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15102:1-15104:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![](https://gitlab.com/logo.png){width="100%"}</span></code></pre> +<pre data-sourcepos="15076:1-15078:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![](https://gitlab.com/logo.png){height="100px"}</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15106:1-15108:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><img src="https://gitlab.com/logo.png" width="100%"></p></span></code></pre> +<pre data-sourcepos="15080:1-15082:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><img src="https://gitlab.com/logo.png" height="100px"></p></span></code></pre> <copy-code></copy-code> </div> </div> +<p data-sourcepos="15085:1-15085:46" dir="auto">Whitespace is tolerated around the delimiters:</p> <div> <div><a href="#example-752">Example 752</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15114:1-15116:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![](https://gitlab.com/logo.png){height="100px"}</span></code></pre> +<pre data-sourcepos="15090:1-15092:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![](https://gitlab.com/logo.png){ width="100" height="100" }</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15118:1-15120:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><img src="https://gitlab.com/logo.png" height="100px"></p></span></code></pre> +<pre data-sourcepos="15094:1-15096:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><img src="https://gitlab.com/logo.png" width="100" height="100"></p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="15123:1-15123:46" dir="auto">Whitespace is tolerated around the delimiters:</p> +<p data-sourcepos="15099:1-15099:54" dir="auto">Attributes must immediately follow the image markdown.</p> <div> <div><a href="#example-753">Example 753</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15128:1-15130:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![](https://gitlab.com/logo.png){ width="100" height="100" }</span></code></pre> +<pre data-sourcepos="15104:1-15106:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![](https://gitlab.com/logo.png) {width="100" height="100"}</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15132:1-15134:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><img src="https://gitlab.com/logo.png" width="100" height="100"></p></span></code></pre> +<pre data-sourcepos="15108:1-15110:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><img src="https://gitlab.com/logo.png"> {width="100" height="100"}</p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="15137:1-15137:54" dir="auto">Attributes must immediately follow the image markdown.</p> +<h2 data-sourcepos="15113:1-15113:12" dir="auto"> +<a id="user-content-footnotes-1" class="anchor" href="#footnotes-1" aria-hidden="true"></a>Footnotes</h2> +<p data-sourcepos="15115:1-15116:143" dir="auto">See +<a href="https://docs.gitlab.com/ee/user/markdown.html#footnotes" rel="nofollow noreferrer noopener" target="_blank">the footnotes section of the user-facing documentation for GitLab Flavored Markdown</a>.</p> <div> <div><a href="#example-754">Example 754</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15142:1-15144:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">![](https://gitlab.com/logo.png) {width="100" height="100"}</span></code></pre> +<pre data-sourcepos="15121:1-15125:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">footnote reference tag [^fortytwo]</span> +<span id="LC2" class="line" lang="plaintext"></span> +<span id="LC3" class="line" lang="plaintext">[^fortytwo]: footnote text</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="15146:1-15148:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p><img src="https://gitlab.com/logo.png"> {width="100" height="100"}</p></span></code></pre> +<pre data-sourcepos="15127:1-15147:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p></span> +<span id="LC2" class="line" lang="plaintext">footnote reference tag</span> +<span id="LC3" class="line" lang="plaintext"><sup></span> +<span id="LC4" class="line" lang="plaintext"><a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref></span> +<span id="LC5" class="line" lang="plaintext">1</span> +<span id="LC6" class="line" lang="plaintext"></a></span> +<span id="LC7" class="line" lang="plaintext"></sup></span> +<span id="LC8" class="line" lang="plaintext"></p></span> +<span id="LC9" class="line" lang="plaintext"><section data-footnotes></span> +<span id="LC10" class="line" lang="plaintext"><ol></span> +<span id="LC11" class="line" lang="plaintext"><li id="fn-fortytwo-42"></span> +<span id="LC12" class="line" lang="plaintext"><p></span> +<span id="LC13" class="line" lang="plaintext">footnote text</span> +<span id="LC14" class="line" lang="plaintext"><a href="#fnref-fortytwo-42" data-footnote-backref></span> +<span id="LC15" class="line" lang="plaintext"></a></span> +<span id="LC16" class="line" lang="plaintext"></p></span> +<span id="LC17" class="line" lang="plaintext"></li></span> +<span id="LC18" class="line" lang="plaintext"></ol></span> +<span id="LC19" class="line" lang="plaintext"></section></span></code></pre> <copy-code></copy-code> </div> </div> diff --git a/glfm_specification/output_example_snapshots/snapshot_spec.md b/glfm_specification/output_example_snapshots/snapshot_spec.md index ccee9c1707e..3b3628032bf 100644 --- a/glfm_specification/output_example_snapshots/snapshot_spec.md +++ b/glfm_specification/output_example_snapshots/snapshot_spec.md @@ -9597,45 +9597,13 @@ Multiple spaces # GitLab Official Specification Markdown -Currently, only some of the GitLab-specific markdown features are -listed in this section. We may eventually add all -GitLab-specific features currently listed as supported in the +Note: This specification is a work in progress. Only some of the official GLFM extensions +are defined. We will continue to add any additional ones found in the [user-facing documentation for GitLab Flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html). There is currently only this single top-level heading, but the examples may be split into multiple top-level headings in the future. -## Footnotes - -See -[the footnotes section of the user-facing documentation for GitLab Flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html#footnotes). - -```````````````````````````````` example gitlab -footnote reference tag [^fortytwo] - -[^fortytwo]: footnote text -. -<p> -footnote reference tag -<sup> -<a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref> -1 -</a> -</sup> -</p> -<section data-footnotes> -<ol> -<li id="fn-fortytwo-42"> -<p> -footnote text -<a href="#fnref-fortytwo-42" data-footnote-backref> -</a> -</p> -</li> -</ol> -</section> -```````````````````````````````` - ## Task list items See @@ -10626,3 +10594,34 @@ Attributes must immediately follow the image markdown. <p><img src="https://gitlab.com/logo.png"> {width="100" height="100"}</p> ```````````````````````````````` +## Footnotes + +See +[the footnotes section of the user-facing documentation for GitLab Flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html#footnotes). + +```````````````````````````````` example gitlab +footnote reference tag [^fortytwo] + +[^fortytwo]: footnote text +. +<p> +footnote reference tag +<sup> +<a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref> +1 +</a> +</sup> +</p> +<section data-footnotes> +<ol> +<li id="fn-fortytwo-42"> +<p> +footnote text +<a href="#fnref-fortytwo-42" data-footnote-backref> +</a> +</p> +</li> +</ol> +</section> +```````````````````````````````` + diff --git a/glfm_specification/output_spec/spec.html b/glfm_specification/output_spec/spec.html index 2a4d03a3fdd..8149afe6124 100644 --- a/glfm_specification/output_spec/spec.html +++ b/glfm_specification/output_spec/spec.html @@ -242,89 +242,58 @@ <li><a href="#introduction">Introduction</a></li> <li> <a href="#gitlab-official-specification-markdown">GitLab Official Specification Markdown</a><ul> -<li><a href="#footnotes">Footnotes</a></li> <li><a href="#task-list-items">Task list items</a></li> <li><a href="#front-matter">Front matter</a></li> <li><a href="#table-of-contents">Table of contents</a></li> </ul> </li> </ul> -<h1 data-sourcepos="3:1-3:14" dir="auto"> +<hr data-sourcepos="3:1-3:3"> +<p data-sourcepos="4:1-6:3" dir="auto">title: GitLab Flavored Markdown (GLFM) Spec +version: alpha +...</p> +<h1 data-sourcepos="8:1-8:14" dir="auto"> <a id="user-content-introduction" class="anchor" href="#introduction" aria-hidden="true"></a>Introduction</h1> -<p data-sourcepos="5:1-5:84" dir="auto">TODO: Write a GitLab-specific version of the GitHub Flavored Markdown intro section.</p> -<p data-sourcepos="7:1-10:75" dir="auto">NOTE: The example numbering in this document does not start at "1", because this official specification +<p data-sourcepos="10:1-10:284" dir="auto">GitLab Flavored Markdown (GLFM) extends the <a href="https://spec.commonmark.org/current/" rel="nofollow noreferrer noopener" target="_blank">CommonMark specification</a> and is considered a strict superset of CommonMark. It also incorporates the extensions defined by the <a href="https://github.github.com/gfm/" rel="nofollow noreferrer noopener" target="_blank">GitHub Flavored Markdown specification</a>.</p> +<p data-sourcepos="12:1-12:433" dir="auto">This specification will define the various official extensions that comprise GLFM. These extensions are GitLab independent - they do not require a GitLab server for parsing or interaction. The intent is to provide a specification that can be implemented in standard markdown editors. This includes many of the features listed in <a href="https://docs.gitlab.com/ee/user/markdown.html" rel="nofollow noreferrer noopener" target="_blank">user-facing documentation for GitLab Flavored Markdown</a>.</p> +<p data-sourcepos="14:1-14:69" dir="auto">The CommonMark and GitHub specifications will not be duplicated here.</p> +<p data-sourcepos="16:1-19:75" dir="auto">NOTE: The example numbering in this document does not start at "1", because this official specification only contains a subset of all the examples which are supported by GitLab Flavored Markdown. See <a href="https://gitlab.com/gitlab-org/gitlab/-/blob/master/glfm_specification/output_example_snapshots/snapshot_spec.html" rel="nofollow noreferrer noopener" target="_blank"><code>snapshot_spec.html</code></a> for a complete list of all examples, which are a superset of examples from:</p> -<ul data-sourcepos="12:1-16:0" dir="auto"> -<li data-sourcepos="12:1-12:12">CommonMark</li> -<li data-sourcepos="13:1-13:26">GitHub Flavored Markdown</li> -<li data-sourcepos="14:1-14:88">GitLab Flavored Markdown Official Specification (the same ones from this specifiation)</li> -<li data-sourcepos="15:1-16:0">GitLab Flavored Markdown Internal Extensions.</li> +<ul data-sourcepos="21:1-25:0" dir="auto"> +<li data-sourcepos="21:1-21:12">CommonMark</li> +<li data-sourcepos="22:1-22:26">GitHub Flavored Markdown</li> +<li data-sourcepos="23:1-23:88">GitLab Flavored Markdown Official Specification (the same ones from this specifiation)</li> +<li data-sourcepos="24:1-25:0">GitLab Flavored Markdown Internal Extensions.</li> </ul> <!-- BEGIN TESTS --> -<h1 data-sourcepos="18:1-18:40" dir="auto"> +<h1 data-sourcepos="27:1-27:40" dir="auto"> <a id="user-content-gitlab-official-specification-markdown" class="anchor" href="#gitlab-official-specification-markdown" aria-hidden="true"></a>GitLab Official Specification Markdown</h1> -<p data-sourcepos="20:1-23:104" dir="auto">Currently, only some of the GitLab-specific markdown features are -listed in this section. We may eventually add all -GitLab-specific features currently listed as supported in the +<p data-sourcepos="29:1-31:104" dir="auto">Note: This specification is a work in progress. Only some of the official GLFM extensions +are defined. We will continue to add any additional ones found in the <a href="https://docs.gitlab.com/ee/user/markdown.html" rel="nofollow noreferrer noopener" target="_blank">user-facing documentation for GitLab Flavored Markdown</a>.</p> -<p data-sourcepos="25:1-26:69" dir="auto">There is currently only this single top-level heading, but the +<p data-sourcepos="33:1-34:69" dir="auto">There is currently only this single top-level heading, but the examples may be split into multiple top-level headings in the future.</p> -<h2 data-sourcepos="28:1-28:12" dir="auto"> -<a id="user-content-footnotes" class="anchor" href="#footnotes" aria-hidden="true"></a>Footnotes</h2> -<p data-sourcepos="30:1-31:143" dir="auto">See -<a href="https://docs.gitlab.com/ee/user/markdown.html#footnotes" rel="nofollow noreferrer noopener" target="_blank">the footnotes section of the user-facing documentation for GitLab Flavored Markdown</a>.</p> -<div> -<div><a href="#example-674">Example 674</a></div> -<div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="36:1-40:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">footnote reference tag [^fortytwo]</span> -<span id="LC2" class="line" lang="plaintext"></span> -<span id="LC3" class="line" lang="plaintext">[^fortytwo]: footnote text</span></code></pre> -<copy-code></copy-code> -</div> -<div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="42:1-62:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p></span> -<span id="LC2" class="line" lang="plaintext">footnote reference tag</span> -<span id="LC3" class="line" lang="plaintext"><sup></span> -<span id="LC4" class="line" lang="plaintext"><a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref></span> -<span id="LC5" class="line" lang="plaintext">1</span> -<span id="LC6" class="line" lang="plaintext"></a></span> -<span id="LC7" class="line" lang="plaintext"></sup></span> -<span id="LC8" class="line" lang="plaintext"></p></span> -<span id="LC9" class="line" lang="plaintext"><section data-footnotes></span> -<span id="LC10" class="line" lang="plaintext"><ol></span> -<span id="LC11" class="line" lang="plaintext"><li id="fn-fortytwo-42"></span> -<span id="LC12" class="line" lang="plaintext"><p></span> -<span id="LC13" class="line" lang="plaintext">footnote text</span> -<span id="LC14" class="line" lang="plaintext"><a href="#fnref-fortytwo-42" data-footnote-backref></span> -<span id="LC15" class="line" lang="plaintext"></a></span> -<span id="LC16" class="line" lang="plaintext"></p></span> -<span id="LC17" class="line" lang="plaintext"></li></span> -<span id="LC18" class="line" lang="plaintext"></ol></span> -<span id="LC19" class="line" lang="plaintext"></section></span></code></pre> -<copy-code></copy-code> -</div> -</div> -<h2 data-sourcepos="65:1-65:18" dir="auto"> +<h2 data-sourcepos="36:1-36:18" dir="auto"> <a id="user-content-task-list-items" class="anchor" href="#task-list-items" aria-hidden="true"></a>Task list items</h2> -<p data-sourcepos="67:1-68:117" dir="auto">See +<p data-sourcepos="38:1-39:117" dir="auto">See <a href="https://docs.gitlab.com/ee/user/markdown.html#task-lists" rel="nofollow noreferrer noopener" target="_blank">Task lists</a> in the GitLab Flavored Markdown documentation.</p> -<p data-sourcepos="70:1-73:39" dir="auto">Task list items (checkboxes) are defined as a GitHub Flavored Markdown extension in a section above. +<p data-sourcepos="41:1-44:39" dir="auto">Task list items (checkboxes) are defined as a GitHub Flavored Markdown extension in a section above. GitLab extends the behavior of task list items to support additional features. Some of these features are in-progress, and should not yet be considered part of the official GitLab Flavored Markdown specification.</p> -<p data-sourcepos="75:1-75:85" dir="auto">Some of the behavior of task list items is implemented as client-side JavaScript/CSS.</p> -<p data-sourcepos="77:1-77:80" dir="auto">The following are some basic examples; more examples may be added in the future.</p> -<p data-sourcepos="79:1-79:16" dir="auto">Incomplete task:</p> +<p data-sourcepos="46:1-46:85" dir="auto">Some of the behavior of task list items is implemented as client-side JavaScript/CSS.</p> +<p data-sourcepos="48:1-48:80" dir="auto">The following are some basic examples; more examples may be added in the future.</p> +<p data-sourcepos="50:1-50:16" dir="auto">Incomplete task:</p> <div> -<div><a href="#example-675">Example 675</a></div> +<div><a href="#example-674">Example 674</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="84:1-86:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [ ] incomplete</span></code></pre> +<pre data-sourcepos="55:1-57:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [ ] incomplete</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="88:1-96:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> +<pre data-sourcepos="59:1-67:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> <span id="LC2" class="line" lang="plaintext"><li></span> <span id="LC3" class="line" lang="plaintext"><task-button/></span> <span id="LC4" class="line" lang="plaintext"><input type="checkbox" disabled/></span> @@ -334,15 +303,15 @@ GitLab Flavored Markdown specification.</p> <copy-code></copy-code> </div> </div> -<p data-sourcepos="99:1-99:15" dir="auto">Completed task:</p> +<p data-sourcepos="70:1-70:15" dir="auto">Completed task:</p> <div> -<div><a href="#example-676">Example 676</a></div> +<div><a href="#example-675">Example 675</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="104:1-106:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [x] completed</span></code></pre> +<pre data-sourcepos="75:1-77:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [x] completed</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="108:1-116:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> +<pre data-sourcepos="79:1-87:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> <span id="LC2" class="line" lang="plaintext"><li></span> <span id="LC3" class="line" lang="plaintext"><task-button/></span> <span id="LC4" class="line" lang="plaintext"><input type="checkbox" checked disabled/></span> @@ -352,15 +321,15 @@ GitLab Flavored Markdown specification.</p> <copy-code></copy-code> </div> </div> -<p data-sourcepos="119:1-119:18" dir="auto">Inapplicable task:</p> +<p data-sourcepos="90:1-90:18" dir="auto">Inapplicable task:</p> <div> -<div><a href="#example-677">Example 677</a></div> +<div><a href="#example-676">Example 676</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="124:1-126:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [~] inapplicable</span></code></pre> +<pre data-sourcepos="95:1-97:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [~] inapplicable</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="128:1-138:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> +<pre data-sourcepos="99:1-109:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> <span id="LC2" class="line" lang="plaintext"><li></span> <span id="LC3" class="line" lang="plaintext"><task-button/></span> <span id="LC4" class="line" lang="plaintext"><input type="checkbox" data-inapplicable disabled></span> @@ -372,18 +341,18 @@ GitLab Flavored Markdown specification.</p> <copy-code></copy-code> </div> </div> -<p data-sourcepos="141:1-142:50" dir="auto">Inapplicable task in a "loose" list. Note that the <code><del></code> tag is not applied to the +<p data-sourcepos="112:1-113:50" dir="auto">Inapplicable task in a "loose" list. Note that the <code><del></code> tag is not applied to the loose text; it has strikethrough applied with CSS.</p> <div> -<div><a href="#example-678">Example 678</a></div> +<div><a href="#example-677">Example 677</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="147:1-151:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [~] inapplicable</span> +<pre data-sourcepos="118:1-122:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">- [~] inapplicable</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext"> text in loose list</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="153:1-168:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> +<pre data-sourcepos="124:1-139:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><ul></span> <span id="LC2" class="line" lang="plaintext"><li></span> <span id="LC3" class="line" lang="plaintext"><p></span> <span id="LC4" class="line" lang="plaintext"><task-button/></span> @@ -400,23 +369,23 @@ loose text; it has strikethrough applied with CSS.</p> <copy-code></copy-code> </div> </div> -<h2 data-sourcepos="171:1-171:15" dir="auto"> +<h2 data-sourcepos="142:1-142:15" dir="auto"> <a id="user-content-front-matter" class="anchor" href="#front-matter" aria-hidden="true"></a>Front matter</h2> -<p data-sourcepos="173:1-174:121" dir="auto">See +<p data-sourcepos="144:1-145:121" dir="auto">See <a href="https://docs.gitlab.com/ee/user/markdown.html#front-matter" rel="nofollow noreferrer noopener" target="_blank">Front matter</a> in the GitLab Flavored Markdown documentation.</p> -<p data-sourcepos="176:1-177:95" dir="auto">Front matter is metadata included at the beginning of a Markdown document, preceding the content. +<p data-sourcepos="147:1-148:95" dir="auto">Front matter is metadata included at the beginning of a Markdown document, preceding the content. This data can be used by static site generators like Jekyll, Hugo, and many other applications.</p> -<p data-sourcepos="179:1-179:18" dir="auto">YAML front matter:</p> +<p data-sourcepos="150:1-150:18" dir="auto">YAML front matter:</p> <div> -<div><a href="#example-679">Example 679</a></div> +<div><a href="#example-678">Example 678</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="184:1-188:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">---</span> +<pre data-sourcepos="155:1-159:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">---</span> <span id="LC2" class="line" lang="plaintext">title: YAML front matter</span> <span id="LC3" class="line" lang="plaintext">---</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="190:1-196:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> +<pre data-sourcepos="161:1-167:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> <span id="LC2" class="line" lang="plaintext"><code></span> <span id="LC3" class="line" lang="plaintext">title: YAML front matter</span> <span id="LC4" class="line" lang="plaintext"></code></span> @@ -424,17 +393,17 @@ This data can be used by static site generators like Jekyll, Hugo, and many othe <copy-code></copy-code> </div> </div> -<p data-sourcepos="199:1-199:18" dir="auto">TOML front matter:</p> +<p data-sourcepos="170:1-170:18" dir="auto">TOML front matter:</p> <div> -<div><a href="#example-680">Example 680</a></div> +<div><a href="#example-679">Example 679</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="204:1-208:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">+++</span> +<pre data-sourcepos="175:1-179:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">+++</span> <span id="LC2" class="line" lang="plaintext">title: TOML front matter</span> <span id="LC3" class="line" lang="plaintext">+++</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="210:1-216:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> +<pre data-sourcepos="181:1-187:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> <span id="LC2" class="line" lang="plaintext"><code></span> <span id="LC3" class="line" lang="plaintext">title: TOML front matter</span> <span id="LC4" class="line" lang="plaintext"></code></span> @@ -442,11 +411,11 @@ This data can be used by static site generators like Jekyll, Hugo, and many othe <copy-code></copy-code> </div> </div> -<p data-sourcepos="219:1-219:18" dir="auto">JSON front matter:</p> +<p data-sourcepos="190:1-190:18" dir="auto">JSON front matter:</p> <div> -<div><a href="#example-681">Example 681</a></div> +<div><a href="#example-680">Example 680</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="224:1-230:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">;;;</span> +<pre data-sourcepos="195:1-201:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">;;;</span> <span id="LC2" class="line" lang="plaintext">{</span> <span id="LC3" class="line" lang="plaintext"> "title": "JSON front matter"</span> <span id="LC4" class="line" lang="plaintext">}</span> @@ -454,7 +423,7 @@ This data can be used by static site generators like Jekyll, Hugo, and many othe <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="232:1-240:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> +<pre data-sourcepos="203:1-211:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><pre></span> <span id="LC2" class="line" lang="plaintext"><code></span> <span id="LC3" class="line" lang="plaintext">{</span> <span id="LC4" class="line" lang="plaintext"> "title": "JSON front matter"</span> @@ -464,11 +433,11 @@ This data can be used by static site generators like Jekyll, Hugo, and many othe <copy-code></copy-code> </div> </div> -<p data-sourcepos="243:1-243:66" dir="auto">Front matter blocks should be inserted at the top of the document:</p> +<p data-sourcepos="214:1-214:66" dir="auto">Front matter blocks should be inserted at the top of the document:</p> <div> -<div><a href="#example-682">Example 682</a></div> +<div><a href="#example-681">Example 681</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="248:1-254:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">text</span> +<pre data-sourcepos="219:1-225:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">text</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext">---</span> <span id="LC4" class="line" lang="plaintext">title: YAML front matter</span> @@ -476,43 +445,43 @@ This data can be used by static site generators like Jekyll, Hugo, and many othe <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="256:1-260:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>text</p></span> +<pre data-sourcepos="227:1-231:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>text</p></span> <span id="LC2" class="line" lang="plaintext"><hr></span> <span id="LC3" class="line" lang="plaintext"><h2>title: YAML front matter</h2></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="263:1-263:74" dir="auto">Front matter block delimiters shouldn’t be preceded by space characters:</p> +<p data-sourcepos="234:1-234:74" dir="auto">Front matter block delimiters shouldn’t be preceded by space characters:</p> <div> -<div><a href="#example-683">Example 683</a></div> +<div><a href="#example-682">Example 682</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="268:1-272:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"> ---</span> +<pre data-sourcepos="239:1-243:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"> ---</span> <span id="LC2" class="line" lang="plaintext">title: YAML front matter</span> <span id="LC3" class="line" lang="plaintext">---</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="274:1-277:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><hr></span> +<pre data-sourcepos="245:1-248:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><hr></span> <span id="LC2" class="line" lang="plaintext"><h2>title: YAML front matter</h2></span></code></pre> <copy-code></copy-code> </div> </div> -<h2 data-sourcepos="280:1-280:20" dir="auto"> +<h2 data-sourcepos="251:1-251:20" dir="auto"> <a id="user-content-table-of-contents" class="anchor" href="#table-of-contents" aria-hidden="true"></a>Table of contents</h2> -<p data-sourcepos="282:1-284:46" dir="auto">See +<p data-sourcepos="253:1-255:46" dir="auto">See <a href="https://docs.gitlab.com/ee/user/markdown.html#table-of-contents" rel="nofollow noreferrer noopener" target="_blank">table of contents</a> in the GitLab Flavored Markdown documentation.</p> -<p data-sourcepos="286:1-290:23" dir="auto">NOTE: Because of this bug (<a href="https://gitlab.com/gitlab-org/gitlab/-/issues/359077" rel="nofollow noreferrer noopener" target="_blank">https://gitlab.com/gitlab-org/gitlab/-/issues/359077</a>), +<p data-sourcepos="257:1-261:23" dir="auto">NOTE: Because of this bug (<a href="https://gitlab.com/gitlab-org/gitlab/-/issues/359077" rel="nofollow noreferrer noopener" target="_blank">https://gitlab.com/gitlab-org/gitlab/-/issues/359077</a>), we cannot actually include the <code>TOC</code> tag with single brackets in backticks in this Markdown document, otherwise it would render a table of contents inline right here. So, it's been switched to <code>[</code> + <code>TOC</code> + <code>]</code> instead. This can be reverted once that bug is fixed.</p> -<p data-sourcepos="292:1-293:76" dir="auto">A table of contents is an unordered list that links to subheadings in the document. +<p data-sourcepos="263:1-264:76" dir="auto">A table of contents is an unordered list that links to subheadings in the document. Add either the <code>[[_TOC_]]</code> tag or the <code>[</code> + <code>TOC</code> + <code>]</code> tag on its own line.</p> <div> -<div><a href="#example-684">Example 684</a></div> +<div><a href="#example-683">Example 683</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="298:1-304:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[TOC]</span> +<pre data-sourcepos="269:1-275:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[TOC]</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext"># Heading 1</span> <span id="LC4" class="line" lang="plaintext"></span> @@ -520,7 +489,7 @@ Add either the <code>[[_TOC_]]</code> tag or the <code>[</code> + <code>TOC</cod <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="306:1-317:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> +<pre data-sourcepos="277:1-288:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> <span id="LC2" class="line" lang="plaintext"> <ul></span> <span id="LC3" class="line" lang="plaintext"> <li><a href="#heading-1">Heading 1</a></li></span> <span id="LC4" class="line" lang="plaintext"> <ul></span> @@ -534,9 +503,9 @@ Add either the <code>[[_TOC_]]</code> tag or the <code>[</code> + <code>TOC</cod </div> </div> <div> -<div><a href="#example-685">Example 685</a></div> +<div><a href="#example-684">Example 684</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="323:1-329:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[[_TOC_]]</span> +<pre data-sourcepos="294:1-300:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[[_TOC_]]</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext"># Heading 1</span> <span id="LC4" class="line" lang="plaintext"></span> @@ -544,7 +513,7 @@ Add either the <code>[[_TOC_]]</code> tag or the <code>[</code> + <code>TOC</cod <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="331:1-342:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> +<pre data-sourcepos="302:1-313:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> <span id="LC2" class="line" lang="plaintext"> <ul></span> <span id="LC3" class="line" lang="plaintext"> <li><a href="#heading-1">Heading 1</a></li></span> <span id="LC4" class="line" lang="plaintext"> <ul></span> @@ -557,12 +526,12 @@ Add either the <code>[[_TOC_]]</code> tag or the <code>[</code> + <code>TOC</cod <copy-code></copy-code> </div> </div> -<p data-sourcepos="345:1-346:5" dir="auto">A table of contents is a block element. It should preceded and followed by a blank +<p data-sourcepos="316:1-317:5" dir="auto">A table of contents is a block element. It should preceded and followed by a blank line.</p> <div> -<div><a href="#example-686">Example 686</a></div> +<div><a href="#example-685">Example 685</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="351:1-357:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[[_TOC_]]</span> +<pre data-sourcepos="322:1-328:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">[[_TOC_]]</span> <span id="LC2" class="line" lang="plaintext">text</span> <span id="LC3" class="line" lang="plaintext"></span> <span id="LC4" class="line" lang="plaintext">text</span> @@ -570,22 +539,22 @@ line.</p> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="359:1-362:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>[[<em>TOC</em>]]text</p></span> +<pre data-sourcepos="330:1-333:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><p>[[<em>TOC</em>]]text</p></span> <span id="LC2" class="line" lang="plaintext"><p>text[TOC]</p></span></code></pre> <copy-code></copy-code> </div> </div> -<p data-sourcepos="365:1-365:60" dir="auto">A table of contents can be indented with up to three spaces.</p> +<p data-sourcepos="336:1-336:60" dir="auto">A table of contents can be indented with up to three spaces.</p> <div> -<div><a href="#example-687">Example 687</a></div> +<div><a href="#example-686">Example 686</a></div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="370:1-374:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"> [[_TOC_]]</span> +<pre data-sourcepos="341:1-345:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="example" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"> [[_TOC_]]</span> <span id="LC2" class="line" lang="plaintext"></span> <span id="LC3" class="line" lang="plaintext"># Heading 1</span></code></pre> <copy-code></copy-code> </div> <div class="gl-relative markdown-code-block js-markdown-code"> -<pre data-sourcepos="376:1-383:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> +<pre data-sourcepos="347:1-354:32" lang="plaintext" class="code highlight js-syntax-highlight language-plaintext" data-canonical-lang="" v-pre="true"><code><span id="LC1" class="line" lang="plaintext"><nav></span> <span id="LC2" class="line" lang="plaintext"> <ul></span> <span id="LC3" class="line" lang="plaintext"> <li><a href="#heading-1">Heading 1</a></li></span> <span id="LC4" class="line" lang="plaintext"> </ul></span> diff --git a/glfm_specification/output_spec/spec.txt b/glfm_specification/output_spec/spec.txt index 350acea770c..10484da5531 100644 --- a/glfm_specification/output_spec/spec.txt +++ b/glfm_specification/output_spec/spec.txt @@ -2,9 +2,18 @@ title: GitLab Flavored Markdown Official Specification version: alpha ... +--- +title: GitLab Flavored Markdown (GLFM) Spec +version: alpha +... + # Introduction -TODO: Write a GitLab-specific version of the GitHub Flavored Markdown intro section. +GitLab Flavored Markdown (GLFM) extends the [CommonMark specification](https://spec.commonmark.org/current/) and is considered a strict superset of CommonMark. It also incorporates the extensions defined by the [GitHub Flavored Markdown specification](https://github.github.com/gfm/). + +This specification will define the various official extensions that comprise GLFM. These extensions are GitLab independent - they do not require a GitLab server for parsing or interaction. The intent is to provide a specification that can be implemented in standard markdown editors. This includes many of the features listed in [user-facing documentation for GitLab Flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html). + +The CommonMark and GitHub specifications will not be duplicated here. NOTE: The example numbering in this document does not start at "1", because this official specification only contains a subset of all the examples which are supported by GitLab Flavored Markdown. See @@ -19,45 +28,13 @@ for a complete list of all examples, which are a superset of examples from: <!-- BEGIN TESTS --> # GitLab Official Specification Markdown -Currently, only some of the GitLab-specific markdown features are -listed in this section. We may eventually add all -GitLab-specific features currently listed as supported in the +Note: This specification is a work in progress. Only some of the official GLFM extensions +are defined. We will continue to add any additional ones found in the [user-facing documentation for GitLab Flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html). There is currently only this single top-level heading, but the examples may be split into multiple top-level headings in the future. -## Footnotes - -See -[the footnotes section of the user-facing documentation for GitLab Flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html#footnotes). - -```````````````````````````````` example gitlab -footnote reference tag [^fortytwo] - -[^fortytwo]: footnote text -. -<p> -footnote reference tag -<sup> -<a href="#fn-fortytwo-42" id="fnref-fortytwo-42" data-footnote-ref> -1 -</a> -</sup> -</p> -<section data-footnotes> -<ol> -<li id="fn-fortytwo-42"> -<p> -footnote text -<a href="#fnref-fortytwo-42" data-footnote-backref> -</a> -</p> -</li> -</ol> -</section> -```````````````````````````````` - ## Task list items See |