Fancy lists in GitLab Markdown


A little-known feature of GitLab-flavoured Markdown is GLQL (GitLab Query Language).

It basically allows you to create neat dynamic lists for work items.

For instance, the above table is created like so:

```glql
display: table
fields: title, project, state, created
title: "Current assignments"
limit: 10
sort: created desc
query: assignee = "jae" and state = opened and group = "general-stuff"
```
YAML

It will basically display as a table all work items in the “general stuff” group assigned to my user.

Within the query, you can also have more complex asks, for instance labels("workflow::*") AS "Workflow" will query all scoped labels workflow and display their values in a column named “Workflows”.

And that’s about it really, just a small feature to spice up your profile. If you need more information, you can always take a peek at the official docs.


Jae's Blog
Jae's Blog
@b@b.j4.lc

Jae’s blog, now federating properly!

137 posts
42 followers
Fediverse Reactions

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *

To respond on your own website, enter the URL of your response which should contain a link to this post’s permalink URL. Your response will then appear (possibly after moderation) on this page. Want to update or remove your response? Update or delete your post and re-enter your post’s URL again. (Find out more about Webmentions.)