[{"data":1,"prerenderedAt":1032},["ShallowReactive",2],{"/blog/how-we-migrated-our-markdown-processing-to-commonmark":3,"navigation-en-us":279,"banner-en-us":717,"footer-en-us":725,"blog-post-authors-en-us-Brett Walker":972,"blog-related-posts-en-us-how-we-migrated-our-markdown-processing-to-commonmark":987,"blog-share-wrapper-en-us":1012,"next-steps-en-us":1022},{"id":4,"title":5,"authors":6,"body":8,"category":259,"date":260,"description":261,"extension":262,"externalUrl":263,"faq":263,"featured":264,"heroImage":265,"hidePromo":264,"meta":266,"navigation":267,"path":268,"seo":269,"slug":273,"stem":274,"tags":275,"template":277,"updatedDate":263,"__hash__":278},"blogPosts/en-us/blog/how-we-migrated-our-markdown-processing-to-commonmark.md","How we migrated to CommonMark",[7],"Brett Walker",{"type":9,"value":10,"toc":251},"minimark",[11,21,26,41,49,58,73,76,79,93,97,106,111,120,128,137,141,149,152,166,170,173,176,180,183,212,225,239,243],[12,13,14,20],"p",{},[15,16,19],"a",{"href":17,"rel":18},"https://daringfireball.net/projects/markdown/",[],"Markdown"," was originally created by John Gruber as a way of writing readable plain text that can be easily converted into HTML or XHTML. Over the years it has become widely adopted for writing online content, whether it's a blog post, discussion threads, documentation, and even books.",[22,23,25],"h3",{"id":24},"why-we-moved-to-commonmark","Why we moved to CommonMark",[12,27,28,29,34,35,40],{},"Various \"flavors\" of Markdown have been created, each with their own extensions and idiosyncrasies. ",[15,30,33],{"href":31,"rel":32},"https://github.github.com/gfm/",[],"GitHub Flavored Markdown"," is one of the most widely used and adopted set of extensions (such as task lists). With all the flavors behaving a little differently, it has become increasingly difficult to write Markdown content and have it ",[15,36,39],{"href":37,"rel":38},"https://babelmark.github.io",[],"properly rendered everywhere",".",[12,42,43,48],{},[15,44,47],{"href":45,"rel":46},"https://docs.gitlab.com/user/markdown/",[],"GitLab uses Markdown extensively"," – almost all user-generated content is written in it, from issue and merge request descriptions, to comments and discussions, wiki pages, etc.",[12,50,51,52,57],{},"The goal of ",[15,53,56],{"href":54,"rel":55},"https://commonmark.org",[],"CommonMark"," is to create \"a strongly defined, highly compatible specification of Markdown\":",[59,60,61],"blockquote",{},[12,62,63,64,68,69,72],{},"We propose a ",[65,66,67],"strong",{},"standard, unambiguous syntax specification for Markdown",", along with a ",[65,70,71],{},"suite of comprehensive tests"," to validate Markdown implementations against this specification. We believe this is necessary, even essential, for the future of Markdown.",[12,74,75],{},"By adopting CommonMark as standard, we move closer to having Markdown files that are consistently rendered across applications. Ideally, Markdown content should be able to be rendered the same on GitHub, GitLab, or any other Markdown-aware application.",[12,77,78],{},"Users have also opened numerous issues about our Markdown not working as they expected. CommonMark solves most of these problems, and therefore gives our users a more consistent and usable experience.",[12,80,81,82,87,88,40],{},"Many platforms have also migrated to CommonMark, including ",[15,83,86],{"href":84,"rel":85},"https://github.com",[],"GitHub"," and ",[15,89,92],{"href":90,"rel":91},"https://discourse.org",[],"Discourse",[22,94,96],{"id":95},"phases-of-migration","Phases of migration",[12,98,99,100,105],{},"We rolled out the migration in phases, wanting to make it as painless as possible. We achieved this with the gracious help of ",[15,101,104],{"href":102,"rel":103},"https://gitlab.com/blackst0ne",[],"@blackst0ne"," who started the effort.",[107,108,110],"h4",{"id":109},"phase-1-only-new-content","Phase 1: Only new content",[12,112,113,114,119],{},"In the first phase (",[15,115,118],{"href":116,"rel":117},"https://docs.gitlab.com/releases/",[],"GitLab 11.1","), we only allowed CommonMark to be used in newly created content, such as issue and merge request descriptions, comments, etc. Any older content, even if edited, would continue to be rendered using RedCarpet.",[12,121,122,123,127],{},"Since we cache rendered Markdown for performance, we keep a ",[124,125,126],"code",{},"cached_markdown_version"," value in our database. Using this, we were able to determine whether the content should be rendered with CommonMark or not. As the largest version number at the time was 3, we designated version 10 as being the start of any CommonMark cached content. Anything less would be considered RedCarpet markdown.",[12,129,130,131,136],{},"Additionally we did not use CommonMark for repository and wiki files.  We wanted a ",[15,132,135],{"href":133,"rel":134},"https://handbook.gitlab.com/handbook/values/#minimal-viable-change-mvc",[],"minimal viable change"," to not only test the waters but minimize any initial problems.",[107,138,140],{"id":139},"phase-2-repository-and-wiki-files","Phase 2: Repository and wiki files",[12,142,143,144,148],{},"The next step (",[15,145,147],{"href":116,"rel":146},[],"GitLab 11.3",") was to allow repository and wiki files to be rendered with CommonMark. This was a bigger change in the sense that existing content could potentially look different.",[12,150,151],{},"In practice, RedCarpet and CommonMark are very similar, as would be expected, and are in general compatible. There are a few instances where the syntax is different, such as the indentation needed for bulleted lists inside a numbered list, or the use of superscripts, which CommonMark does not support. For most documents, no change is needed.",[12,153,154,155,160,161,40],{},"However we also knew that we couldn't touch user files or do any sort of migration. Instead, we created a ",[15,156,159],{"href":157,"rel":158},"https://gitlab.com/digitalmoksha/diff_redcarpet_cmark",[],"small tool"," that can generate the changes necessary for files to be converted. This is done by rendering into HTML using RedCarpet, and then generating CommonMark from it using ",[15,162,165],{"href":163,"rel":164},"https://pandoc.org",[],"Pandoc",[107,167,169],{"id":168},"phase-3-commonmark-throughout","Phase 3: CommonMark throughout",[12,171,172],{},"The final phase was to remove RedCarpet completely. By this time, CommonMark had been in use for several months – only older content was still being rendered with RedCarpet. However, we were accumulating technical debt by supporting both methods – new functionality or security fixes had to consider both renderers.",[12,174,175],{},"With RedCarpet removed, we now display older content with CommonMark. Differences are small and only affect a small percentage of the overall content, and the possibility of looking at older issues or merge requests decreases with time.",[107,177,179],{"id":178},"improvements-upstream","Improvements upstream",[12,181,182],{},"There were a couple of issues we ran into during the implementation where we were able to drive some changes to the upstream libraries.",[12,184,185,186,189,190,195,196,201,202,205,206,211],{},"The first is that RedCarpet supports using ",[124,187,188],{},"~~"," to indicate using strikethrough. We use ",[15,191,194],{"href":192,"rel":193},"https://github.com/github/cmark-gfm",[],"cmark-gfm"," for rendering, giving us both CommonMark and common GitHub Flavored Markdown extensions. And although it supports using any number of tildes for strikethrough, we wanted to make the transition a little easier by ",[15,197,200],{"href":198,"rel":199},"https://github.com/github/cmark-gfm/issues/71",[],"only supporting double tildes",". A new option, ",[124,203,204],{},"CMARK_OPT_STRIKETHROUGH_DOUBLE_TILDE",", was added to ",[15,207,210],{"href":208,"rel":209},"https://github.com/gjtorikian/commonmarker/commit/1a973ba872e50b22ee53652ffa12cdfe2fe90155",[]," gjtorikian/commonmarker",", allowing us to turn on support for double-tilde strikethroughs.",[12,213,214,215,220,221,224],{},"Second, we found a bug in ",[15,216,219],{"href":217,"rel":218},"https://github.com/gjtorikian/commonmarker/issues/56",[],"gjtorikian/commonmarker",", where a ",[124,222,223],{},"\u003Ctbody>"," wasn't getting rendered. This was quickly fixed.",[12,226,227,228,87,233,238],{},"Many thanks to ",[15,229,232],{"href":230,"rel":231},"https://github.com/kivikakk",[],"@kivikakk",[15,234,237],{"href":235,"rel":236},"https://github.com/gjtorikian",[],"@gjtorikian"," for their help with these issues.",[22,240,242],{"id":241},"conclusion","Conclusion",[12,244,245,246,250],{},"The transition took several months, but we're happy to have moved our Markdown processing to the next level. And should you run into the few problematic edge cases, ",[15,247,249],{"href":157,"rel":248},[],"diff_redcarpet_cmark"," should be able to help.",{"title":252,"searchDepth":253,"depth":253,"links":254},"",2,[255,257,258],{"id":24,"depth":256,"text":25},3,{"id":95,"depth":256,"text":96},{"id":241,"depth":256,"text":242},"engineering","2019-06-13","A senior backend engineer shares how (and why) we migrated our Markdown processing from RedCarpet to CommonMark.","md",null,false,"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749671172/Blog/Hero%20Images/markdown-tutorial-cover.png",{},true,"/en-us/blog/how-we-migrated-our-markdown-processing-to-commonmark",{"title":5,"description":261,"ogTitle":5,"ogDescription":261,"noIndex":264,"ogImage":265,"ogUrl":270,"ogSiteName":271,"ogType":272,"canonicalUrls":270},"https://about.gitlab.com/blog/how-we-migrated-our-markdown-processing-to-commonmark","https://about.gitlab.com","article","how-we-migrated-our-markdown-processing-to-commonmark","en-us/blog/how-we-migrated-our-markdown-processing-to-commonmark",[276],"collaboration","BlogPost","MEBiSn9zbDiLB3QLzvc7IWN7oF0lieggkCgnATwlnH4",{"logo":280,"freeTrial":285,"sales":290,"login":295,"items":300,"search":636,"minimal":668,"duo":687,"switchNav":696,"pricingDeployment":707},{"config":281},{"href":282,"dataGaName":283,"dataGaLocation":284},"/","gitlab logo","header",{"text":286,"config":287},"Get free trial",{"href":288,"dataGaName":289,"dataGaLocation":284},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com&glm_content=default-saas-trial/","free trial",{"text":291,"config":292},"Request a demo",{"href":293,"dataGaName":294,"dataGaLocation":284},"/request-a-demo/","sales",{"text":296,"config":297},"Sign in",{"href":298,"dataGaName":299,"dataGaLocation":284},"https://gitlab.com/users/sign_in/","sign in",[301,387,475,480,560,614],{"text":302,"left":267,"config":303,"menu":305},"Platform",{"dataNavLevelOne":304},"platform",{"type":306,"link":307,"columns":311,"feature":376},"lists",{"text":308,"config":309},"Explore the Platform",{"href":310,"dataGaName":304,"dataGaLocation":284},"/platform/",[312,335,358],{"title":313,"items":314},"DevOps",[315,320,325,330],{"text":316,"config":317},"CI/CD",{"href":318,"dataGaLocation":284,"dataGaName":319},"/solutions/continuous-integration/","ci/cd",{"text":321,"config":322},"Source Code Management",{"href":323,"dataGaLocation":284,"dataGaName":324},"/solutions/source-code-management/","source code management",{"text":326,"config":327},"Agile Delivery",{"href":328,"dataGaLocation":284,"dataGaName":329},"/solutions/agile-delivery/","agile delivery",{"text":331,"config":332},"Artifact Management",{"href":333,"dataGaLocation":284,"dataGaName":334},"/artifact-central/","artifact management",{"title":336,"items":337},"Security & Governance",[338,343,348,353],{"text":339,"config":340},"Application Security Testing",{"href":341,"dataGaLocation":284,"dataGaName":342},"/solutions/application-security-testing/","application security testing",{"text":344,"config":345},"Governance & Compliance",{"href":346,"dataGaLocation":284,"dataGaName":347},"/solutions/software-compliance/","governance and compliance",{"text":349,"config":350},"Secrets Management",{"href":351,"dataGaLocation":284,"dataGaName":352},"/gitlab-secrets-manager/","secrets management",{"text":354,"config":355},"Supply Chain Security",{"href":356,"dataGaLocation":284,"dataGaName":357},"/solutions/supply-chain/","supply chain security",{"title":359,"items":360},"Agentic AI & Context",[361,366,371],{"text":362,"config":363},"Duo Agent Platform",{"href":364,"dataGaLocation":284,"dataGaName":365},"/gitlab-duo-agent-platform/","duo agent platform",{"text":367,"config":368},"Orbit Context Graph",{"href":369,"dataGaLocation":284,"dataGaName":370},"/gitlab-orbit/","orbit",{"text":372,"config":373},"Visibility & Measurement",{"href":374,"dataGaLocation":284,"dataGaName":375},"/solutions/visibility-measurement/","visibility and measurement",{"config":377,"title":380,"text":381,"link":382},{"background":378,"textColor":379},"url('https://res.cloudinary.com/about-gitlab-com/image/upload/v1790185102/o7dn32anqcb6z8dgd3as.jpg')","#000","GitLab Orbit is generally available","Higher agent accuracy, lower token cost",{"text":383,"config":384},"Read the announcement",{"href":385,"dataGaName":386,"dataGaLocation":284},"/blog/gitlab-orbit-ga/","orbit ga announcement",{"text":388,"left":267,"config":389,"menu":391},"Solutions",{"dataNavLevelOne":390},"solutions",{"type":306,"link":392,"columns":396,"feature":466},{"text":393,"config":394},"View all Solutions",{"href":395,"dataGaName":390,"dataGaLocation":284},"/solutions/",[397,415,433],{"title":398,"items":399},"Outcomes",[400,405,410],{"text":401,"config":402},"DevOps Modernization",{"href":403,"dataGaLocation":284,"dataGaName":404},"/assessments/devops-modernization-assessment/","devops modernization",{"text":406,"config":407},"Security Modernization",{"href":408,"dataGaLocation":284,"dataGaName":409},"/assessments/security-modernization-assessment/","security modernization",{"text":411,"config":412},"AI Modernization",{"href":413,"dataGaLocation":284,"dataGaName":414},"/assessments/ai-modernization-assessment/","ai modernization",{"title":416,"items":417},"By size",[418,423,428],{"text":419,"config":420},"Enterprise",{"href":421,"dataGaLocation":284,"dataGaName":422},"/enterprise/","enterprise",{"text":424,"config":425},"Small Business",{"href":426,"dataGaLocation":284,"dataGaName":427},"/small-business/","small business",{"text":429,"config":430},"Startups",{"href":431,"dataGaLocation":284,"dataGaName":432},"/solutions/startups/","startups",{"title":434,"items":435},"Industries",[436,441,446,451,456,461],{"text":437,"config":438},"Financial Services",{"href":439,"dataGaLocation":284,"dataGaName":440},"/solutions/finance/","financial services",{"text":442,"config":443},"Public Sector",{"href":444,"dataGaLocation":284,"dataGaName":445},"/solutions/public-sector/","public sector",{"text":447,"config":448},"Telecommunications",{"href":449,"dataGaLocation":284,"dataGaName":450},"/solutions/telecommunications/","telecommunications",{"text":452,"config":453},"Automotive",{"href":454,"dataGaLocation":284,"dataGaName":455},"/solutions/automotive/","automotive",{"text":457,"config":458},"Education",{"href":459,"dataGaLocation":284,"dataGaName":460},"/solutions/education/","education",{"text":462,"config":463},"Aerospace",{"href":464,"dataGaLocation":284,"dataGaName":465},"/solutions/aerospace/","aerospace",{"config":467,"title":468,"text":469,"link":470},{"background":378,"textColor":379},"GitLab Security Standard","Learn how to harden your software factory and let AI agents earn autonomy, without trading away security.",{"text":471,"config":472},"Explore the standard",{"href":473,"dataGaName":474,"dataGaLocation":284},"/gitlab-security-standard/","gitlab security standard",{"text":476,"config":477},"Pricing",{"href":478,"dataGaName":479,"dataGaLocation":284,"dataNavLevelOne":479},"/pricing/","pricing",{"text":481,"config":482,"menu":484},"Resources",{"dataNavLevelOne":483},"resources",{"type":306,"link":485,"columns":489,"feature":551},{"text":486,"config":487},"View all resources",{"href":488,"dataGaName":483,"dataGaLocation":284},"/resources/",[490,523],{"title":491,"items":492},"Discover",[493,498,503,508,513,518],{"text":494,"config":495},"Docs",{"href":496,"dataGaName":497,"dataGaLocation":284},"https://docs.gitlab.com/","docs",{"text":499,"config":500},"University",{"href":501,"dataGaName":502,"dataGaLocation":284},"https://university.gitlab.com/","university",{"text":504,"config":505},"Demo Series",{"href":506,"dataGaName":507,"dataGaLocation":284},"/gitlab-technical-demo-series/","demo series",{"text":509,"config":510},"Demo Hub",{"href":511,"dataGaName":512,"dataGaLocation":284},"/demo-hub/","demo hub",{"text":514,"config":515},"Services",{"href":516,"dataGaName":517,"dataGaLocation":284},"/services/","services",{"text":519,"config":520},"Well Architected",{"href":521,"dataGaName":522,"dataGaLocation":284},"/resources/well-architected/","well architected",{"title":524,"items":525},"Connect",[526,531,536,541,546],{"text":527,"config":528},"Blog",{"href":529,"dataGaName":530,"dataGaLocation":284},"/blog/","blog",{"text":532,"config":533},"Community",{"href":534,"dataGaName":535,"dataGaLocation":284},"/community/","community",{"text":537,"config":538},"Customers",{"href":539,"dataGaName":540,"dataGaLocation":284},"/customers/","customers",{"text":542,"config":543},"Partners",{"href":544,"dataGaName":545,"dataGaLocation":284},"/partners/","partners",{"text":547,"config":548},"Events",{"href":549,"dataGaName":550,"dataGaLocation":284},"/events/","events",{"config":552,"title":553,"text":554,"link":555},{"background":378,"textColor":379},"What’s new in GitLab","Stay updated with our latest features and improvements.",{"text":556,"config":557},"Read the latest",{"href":558,"dataGaName":559,"dataGaLocation":284},"/whats-new/","whats new",{"text":561,"config":562,"menu":564},"Company",{"dataNavLevelOne":563},"company",{"type":306,"columns":565},[566],{"items":567},[568,573,579,584,589,594,599,604,609],{"text":569,"config":570},"About",{"href":571,"dataGaName":572,"dataGaLocation":284},"/company/","about",{"text":574,"config":575,"footerGa":578},"Jobs",{"href":576,"dataGaName":577,"dataGaLocation":284},"/jobs/","jobs",{"dataGaName":577},{"text":580,"config":581},"Press",{"href":582,"dataGaName":583,"dataGaLocation":284},"/press/","press",{"text":585,"config":586},"Handbook",{"href":587,"dataGaName":588,"dataGaLocation":284},"https://handbook.gitlab.com/","handbook",{"text":590,"config":591},"Leadership",{"href":592,"dataGaName":593,"dataGaLocation":284},"/company/team/e-group/","leadership",{"text":595,"config":596},"Investor relations",{"href":597,"dataGaName":598,"dataGaLocation":284},"https://ir.gitlab.com/overview/default.aspx","investor relations",{"text":600,"config":601},"Trust Center",{"href":602,"dataGaName":603,"dataGaLocation":284},"/security/","trust center",{"text":605,"config":606},"AI Transparency Center",{"href":607,"dataGaName":608,"dataGaLocation":284},"/ai-transparency-center/","ai transparency center",{"text":610,"config":611},"Newsletter",{"href":612,"dataGaName":613,"dataGaLocation":284},"/company/contact/#contact-forms","newsletter",{"text":615,"config":616,"menu":617},"Contact us",{"dataNavLevelOne":563},{"type":306,"columns":618},[619],{"items":620},[621,626,631],{"text":622,"config":623},"Talk to sales",{"href":624,"dataGaName":625,"dataGaLocation":284},"/sales/","talk to sales",{"text":627,"config":628},"Support portal",{"href":629,"dataGaName":630,"dataGaLocation":284},"https://support.gitlab.com/hc/en-us","support portal",{"text":632,"config":633},"Customer portal",{"href":634,"dataGaName":635,"dataGaLocation":284},"https://customers.gitlab.com/customers/sign_in/","customer portal",{"close":637,"login":638,"suggestions":645},"Close",{"text":639,"link":640},"To search repositories and projects, login to",{"text":641,"config":642},"gitlab.com",{"href":298,"dataGaName":643,"dataGaLocation":644},"search login","search",{"text":646,"default":647},"Suggestions",[648,651,654,656,660,664],{"text":649,"config":650},"GitLab Duo Agent Platform",{"href":364,"dataGaName":649,"dataGaLocation":644},{"text":652,"config":653},"Code Suggestions (AI)",{"href":364,"dataGaName":652,"dataGaLocation":644},{"text":316,"config":655},{"href":318,"dataGaName":316,"dataGaLocation":644},{"text":657,"config":658},"GitLab on AWS",{"href":659,"dataGaName":657,"dataGaLocation":644},"/partners/technology-partners/aws/",{"text":661,"config":662},"GitLab on Google Cloud",{"href":663,"dataGaName":661,"dataGaLocation":644},"/partners/technology-partners/google-cloud-platform/",{"text":665,"config":666},"Why GitLab?",{"href":667,"dataGaName":665,"dataGaLocation":644},"/why-gitlab/",{"freeTrial":669,"mobileIcon":674,"desktopIcon":679,"secondaryButton":682},{"text":670,"config":671},"Start free trial",{"href":672,"dataGaName":289,"dataGaLocation":673},"https://gitlab.com/-/trials/new/","nav",{"altText":675,"config":676},"Gitlab Icon",{"src":677,"dataGaName":678,"dataGaLocation":673},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203874/jypbw1jx72aexsoohd7x.svg","gitlab icon",{"altText":675,"config":680},{"src":681,"dataGaName":678,"dataGaLocation":673},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203875/gs4c8p8opsgvflgkswz9.svg",{"text":683,"config":684},"Get Started",{"href":685,"dataGaName":686,"dataGaLocation":673},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com/get-started/","get started",{"freeTrial":688,"mobileIcon":692,"desktopIcon":694},{"text":689,"config":690},"Learn more about GitLab Duo",{"href":364,"dataGaName":691,"dataGaLocation":673},"gitlab duo",{"altText":675,"config":693},{"src":677,"dataGaName":678,"dataGaLocation":673},{"altText":675,"config":695},{"src":681,"dataGaName":678,"dataGaLocation":673},{"button":697,"mobileIcon":702,"desktopIcon":704},{"text":698,"config":699},"/switch",{"href":700,"dataGaName":701,"dataGaLocation":673},"#contact","switch",{"altText":675,"config":703},{"src":677,"dataGaName":678,"dataGaLocation":673},{"altText":675,"config":705},{"src":706,"dataGaName":678,"dataGaLocation":673},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1773335277/ohhpiuoxoldryzrnhfrh.png",{"freeTrial":708,"mobileIcon":713,"desktopIcon":715},{"text":709,"config":710},"Back to pricing",{"href":478,"dataGaName":711,"dataGaLocation":673,"icon":712},"back to pricing","GoBack",{"altText":675,"config":714},{"src":677,"dataGaName":678,"dataGaLocation":673},{"altText":675,"config":716},{"src":681,"dataGaName":678,"dataGaLocation":673},{"title":718,"button":719,"config":723},"GitLab Orbit is generally available. Increase agent accuracy and lower token cost",{"text":383,"config":720},{"href":385,"dataGaName":721,"dataGaLocation":722},"orbit-ga-banner","global-banner",{"layout":724,"disabled":264},"release",{"data":726},{"text":727,"config":728,"items":733,"minimal":961},"Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license",{"twitter":729,"facebook":730,"youtube":731,"linkedin":732},"https://twitter.com/gitlab","https://www.facebook.com/gitlab","https://www.youtube.com/channel/UCnMGQ8QHMAnVIsI3xJrihhg","https://www.linkedin.com/company/gitlab-com",[734,782,841,888,929],{"title":476,"links":735,"subMenu":751},[736,741,746],{"text":737,"config":738},"View plans",{"href":478,"dataGaName":739,"dataGaLocation":740},"view plans","footer",{"text":742,"config":743},"Why Premium?",{"href":744,"dataGaName":745,"dataGaLocation":740},"/pricing/premium/","why premium",{"text":747,"config":748},"Why Ultimate?",{"href":749,"dataGaName":750,"dataGaLocation":740},"/pricing/ultimate/","why ultimate",[752],{"title":753,"links":754},"Contact Us",[755,758,760,762,767,772,777],{"text":756,"config":757},"Contact sales",{"href":624,"dataGaName":294,"dataGaLocation":740},{"text":627,"config":759},{"href":629,"dataGaName":630,"dataGaLocation":740},{"text":632,"config":761},{"href":634,"dataGaName":635,"dataGaLocation":740},{"text":763,"config":764},"Status",{"href":765,"dataGaName":766,"dataGaLocation":740},"https://status.gitlab.com/","status",{"text":768,"config":769},"Terms of use",{"href":770,"dataGaName":771,"dataGaLocation":740},"/terms/","terms of use",{"text":773,"config":774},"Privacy statement",{"href":775,"dataGaName":776,"dataGaLocation":740},"/privacy/","privacy statement",{"text":778,"config":779},"Cookie preferences",{"dataGaName":780,"dataGaLocation":740,"id":781,"isOneTrustButton":267},"cookie preferences","ot-sdk-btn",{"title":302,"links":783,"subMenu":799},[784,787,789,791,793,795],{"text":785,"config":786},"Explore the platform",{"href":310,"dataGaName":304,"dataGaLocation":740},{"text":362,"config":788},{"href":364,"dataGaName":365,"dataGaLocation":740},{"text":316,"config":790},{"href":318,"dataGaName":319,"dataGaLocation":740},{"text":367,"config":792},{"href":369,"dataGaName":370,"dataGaLocation":740},{"text":349,"config":794},{"href":351,"dataGaName":352,"dataGaLocation":740},{"text":796,"config":797},"Why GitLab",{"href":667,"dataGaName":798,"dataGaLocation":740},"why gitlab",[800],{"title":801,"links":802},"Topics",[803,807,812,816,821,826,831,836],{"text":316,"config":804},{"href":805,"dataGaName":806,"dataGaLocation":740},"/topics/ci-cd/","cicd",{"text":808,"config":809},"GitOps",{"href":810,"dataGaName":811,"dataGaLocation":740},"/topics/gitops/","gitops",{"text":313,"config":813},{"href":814,"dataGaName":815,"dataGaLocation":740},"/topics/devops/","devops",{"text":817,"config":818},"Version Control",{"href":819,"dataGaName":820,"dataGaLocation":740},"/topics/version-control/","version control",{"text":822,"config":823},"DevSecOps",{"href":824,"dataGaName":825,"dataGaLocation":740},"/topics/devsecops/","devsecops",{"text":827,"config":828},"Cloud Native",{"href":829,"dataGaName":830,"dataGaLocation":740},"/topics/cloud-native/","cloud native",{"text":832,"config":833},"AI for Coding",{"href":834,"dataGaName":835,"dataGaLocation":740},"/topics/devops/ai-for-coding/","ai for coding",{"text":837,"config":838},"Agentic AI",{"href":839,"dataGaName":840,"dataGaLocation":740},"/topics/agentic-ai/","agentic ai",{"title":388,"links":842},[843,846,849,852,855,858,860,862,864,866,868,871,873,876,880,884],{"text":844,"config":845},"DevOps modernization",{"href":403,"dataGaName":404,"dataGaLocation":740},{"text":847,"config":848},"Security modernization",{"href":408,"dataGaName":409,"dataGaLocation":740},{"text":850,"config":851},"AI modernization",{"href":413,"dataGaName":414,"dataGaLocation":740},{"text":853,"config":854},"Financial services",{"href":439,"dataGaName":440,"dataGaLocation":740},{"text":856,"config":857},"Public sector",{"href":444,"dataGaName":445,"dataGaLocation":740},{"text":447,"config":859},{"href":449,"dataGaName":450,"dataGaLocation":740},{"text":452,"config":861},{"href":454,"dataGaName":455,"dataGaLocation":740},{"text":457,"config":863},{"href":459,"dataGaName":460,"dataGaLocation":740},{"text":462,"config":865},{"href":464,"dataGaName":465,"dataGaLocation":740},{"text":419,"config":867},{"href":421,"dataGaName":422,"dataGaLocation":740},{"text":869,"config":870},"Small business",{"href":426,"dataGaName":427,"dataGaLocation":740},{"text":429,"config":872},{"href":431,"dataGaName":432,"dataGaLocation":740},{"text":808,"config":874},{"href":875,"dataGaName":811,"dataGaLocation":740},"/solutions/gitops/",{"text":877,"config":878},"Software composition analysis",{"href":356,"dataGaName":879,"dataGaLocation":740},"software composition analysis",{"text":881,"config":882},"Value stream management",{"href":374,"dataGaName":883,"dataGaLocation":740},"value stream management",{"text":885,"config":886},"All solutions",{"href":395,"dataGaName":887,"dataGaLocation":740},"all solutions",{"title":481,"links":889},[890,895,900,902,904,906,908,910,912,914,916,918,920,922,925],{"text":891,"config":892},"Install",{"href":893,"dataGaName":894,"dataGaLocation":740},"/install/","install",{"text":896,"config":897},"Quick start guides",{"href":898,"dataGaName":899,"dataGaLocation":740},"/get-started/","quick setup checklists",{"text":494,"config":901},{"href":496,"dataGaName":497,"dataGaLocation":740},{"text":499,"config":903},{"href":501,"dataGaName":502,"dataGaLocation":740},{"text":504,"config":905},{"href":506,"dataGaName":507,"dataGaLocation":740},{"text":509,"config":907},{"href":511,"dataGaName":512,"dataGaLocation":740},{"text":514,"config":909},{"href":516,"dataGaName":517,"dataGaLocation":740},{"text":527,"config":911},{"href":529,"dataGaName":530,"dataGaLocation":740},{"text":532,"config":913},{"href":534,"dataGaName":535,"dataGaLocation":740},{"text":537,"config":915},{"href":539,"dataGaName":540,"dataGaLocation":740},{"text":542,"config":917},{"href":544,"dataGaName":545,"dataGaLocation":740},{"text":547,"config":919},{"href":549,"dataGaName":550,"dataGaLocation":740},{"text":610,"config":921},{"href":612,"dataGaName":613,"dataGaLocation":740},{"text":923,"config":924},"What's new",{"href":558,"dataGaName":559,"dataGaLocation":740},{"text":926,"config":927},"All resources",{"href":488,"dataGaName":928,"dataGaLocation":740},"all resources",{"title":561,"links":930},[931,933,935,937,939,941,943,945,947,951,956],{"text":569,"config":932},{"href":571,"dataGaName":563,"dataGaLocation":740},{"text":574,"config":934},{"href":576,"dataGaName":577,"dataGaLocation":740},{"text":580,"config":936},{"href":582,"dataGaName":583,"dataGaLocation":740},{"text":585,"config":938},{"href":587,"dataGaName":588,"dataGaLocation":740},{"text":590,"config":940},{"href":592,"dataGaName":593,"dataGaLocation":740},{"text":595,"config":942},{"href":597,"dataGaName":598,"dataGaLocation":740},{"text":600,"config":944},{"href":602,"dataGaName":603,"dataGaLocation":740},{"text":605,"config":946},{"href":607,"dataGaName":608,"dataGaLocation":740},{"text":948,"config":949},"Sustainability",{"href":950,"dataGaName":948,"dataGaLocation":740},"/sustainability/",{"text":952,"config":953},"Diversity, inclusion and belonging (DIB)",{"href":954,"dataGaName":955,"dataGaLocation":740},"/diversity-inclusion-belonging/","Diversity, inclusion and belonging",{"text":957,"config":958},"Modern Slavery Transparency Statement",{"href":959,"dataGaName":960,"dataGaLocation":740},"https://handbook.gitlab.com/handbook/legal/modern-slavery-act-transparency-statement/","modern slavery transparency statement",{"items":962},[963,966,969],{"text":964,"config":965},"Terms",{"href":770,"dataGaName":771,"dataGaLocation":740},{"text":967,"config":968},"Cookies",{"dataGaName":780,"dataGaLocation":740,"id":781,"isOneTrustButton":267},{"text":970,"config":971},"Privacy",{"href":775,"dataGaName":776,"dataGaLocation":740},[973],{"id":974,"title":7,"body":263,"config":975,"content":977,"description":263,"extension":981,"meta":982,"navigation":267,"path":983,"seo":984,"stem":985,"__hash__":986},"blogAuthors/en-us/blog/authors/brett-walker.yml",{"template":976},"BlogAuthor",{"name":7,"config":978},{"headshot":979,"ctfId":980},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749670155/Blog/Author%20Headshots/digitalmoksha-headshot.jpg","digitalmoksha","yml",{},"/en-us/blog/authors/brett-walker",{},"en-us/blog/authors/brett-walker","ktLx8H0sWL7REEk1p_RJaxT-uuNjGcn89CyctrJ-ELE",[988,996,1004],{"title":989,"description":990,"heroImage":991,"category":259,"date":992,"authors":993,"slug":995,"externalUrl":263},"Two front doors: Module-level access in a Django GRC app","A technical deep-dive on restructuring a Django internal tool to support two distinct GitLab teams: Security Compliance and Internal Audit.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1750097663/Blog/Hero%20Images/Blog/Hero%20Images/Workflow%201800x945_2gQoQIbY9NvjLFpXtsxtXy_1750097663612.png","2026-10-05",[994],"Donovan Felton","module-level-access-in-a-django-grc-app",{"title":997,"description":998,"heroImage":999,"category":259,"date":1000,"authors":1001,"slug":1003,"externalUrl":263},"How GitLab reduced code-per-agentic-flow ratio by 45%","Learn how Flow Registry, a component-based framework that compiles YAML configurations into fully functional LangGraph flows, helped improve scalability and more.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1774465167/n5hlvrsrheadeccyr1oz.png","2026-09-22",[1002],"Mikolaj Wawrzyniak","how-gitlab-reduced-code-per-agentic-flow-ratio",{"title":1005,"description":1006,"heroImage":1007,"category":259,"date":1008,"authors":1009,"slug":1011,"externalUrl":263},"Co-Create: Building GitLab with our users","How GitLab users collaborated with us to build practical product improvements in the first half of 2026.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1750099203/Blog/Hero%20Images/Blog/Hero%20Images/blog-image-template-1800x945%20%2820%29_2bJGC5ZP3WheoqzlLT05C5_1750099203484.png","2026-09-10",[1010],"Isa Huerga","co-create-h1-2026",{"header":1013,"text":1014,"button":1018,"disclaimer":1021},"Start your free\n\n30-day GitLab trial\n",[1015,1016,1017],"GitLab Duo Agent Platform access","Try our most advanced features","Automate complex tasks with AI",{"text":286,"config":1019},{"href":1020,"dataGaName":289,"dataGaLocation":530},"https://gitlab.com/-/trials/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/blog/","No credit card required.",{"header":1023,"blurb":1024,"button":1025,"secondaryButton":1030},"Start building faster today","See what your team can do with the intelligent orchestration platform for DevSecOps.\n",{"text":1026,"config":1027},"Get your free trial",{"href":1028,"dataGaName":289,"dataGaLocation":1029},"https://gitlab.com/-/trial_registrations/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/","feature",{"text":756,"config":1031},{"href":624,"dataGaName":294,"dataGaLocation":1029},1794911780512]