매크로는 [[ + MacroName + (Parameter) + ]] 형태로 함수호출과 비슷합니다.
인자가 없는 매크로는 [[Br]]처럼 쓰고, 인자가 있는 매크로는 [[Image(/public/favicon.png,20px)]]처럼 씁니다. [[ 바로 뒤에 공백을 두면 매크로로 읽지 않습니다.
문서 안에서 짧은 기능을 호출하거나, 다른 페이지/미디어/상태 메시지를 삽입할 때 사용합니다.
1. 괄호를 빼고 써도 됩니다
[[Kbd]] 는 [[Kbd()]] 와 같습니다. 인자를 받는 매크로라면 인자가 빈 것으로 읽습니다 — MacroImage 는 대체 이미지를, MacroEmbed 는 아래 인자를 알아듣지 못하면 의 오류 상자를 보여 줍니다.
2026-09-25 전에는 그 다섯이 문서를 500 으로 만들었습니다. Image · Attachment · Copyable · Embed · Kbd 는 인자를 바로 읽는데, 괄호가 없으면 인자 자리가 비어 있는 게 아니라 아예 없어서(null) 예외가 났습니다. [[Image()]] 는 멀쩡하고 [[Image]] 만 그랬습니다. 매크로 한 개의 실수가 문서 전체를 안 열리게 만든 셈입니다.
2. 인자를 알아듣지 못하면
날짜·색상 코드·YouTube 주소처럼 형식이 정해진 인자를 받는 매크로는, 인자를 알아듣지 못하면 오류 상자에 Argument Error - [[MacroName(인자)]] 를 씁니다. 쓴 그대로를 되돌려 보여주므로, 어느 매크로의 어떤 인자가 문제인지 문서에서 바로 보입니다. 인자를 생략해 페이지 이름이 대신 쓰였다면 그 이름이 인자 자리에 나옵니다. 오류 상자 없이 다르게 답하는 매크로도 있습니다 — Period 는 쓴 그대로를 글자로 돌려주고, Image 는 대체 이미지를 씁니다.
문구는 TraitMacro.argumentError 한 곳에서 만듭니다. 매크로마다 따로 쓰면 표현이 갈라져 같은 실패가 다른 실패처럼 보입니다.
인자를 알아듣지 못한 것이 아니라 그리다가 예외를 낸 매크로도 그 자리에 [[이름(인자)]] failed - 예외 상자로 나오고, 문서의 나머지는 그대로입니다(2026-09-26 부터, Interpreter 의 그리다 실패하면 과 같은 결정). 위 「괄호를 빼고 써도 됩니다」 의 다섯 매크로가 문서를 500 으로 만들던 것이 이 상자 하나로 막힐 일이었습니다.
| Raw | Preview |
|---|---|
* 줄바꿈: 첫 줄[[Br]]둘째 줄 * 단축키: [[Kbd(Ctrl S)]] * 안내: [[Info(간단한 안내 메시지)]] |
|
3. 서식/텍스트
- MacroBr - 강제 줄바꿈
- MacroKbd - 키보드 키 표시
- MacroRuby - 루비 주석 표시
- MacroTrivial - 덜 중요한 텍스트
- MacroColorCode - 색상 코드 미리보기
- MacroCopyable - 복사 버튼이 있는 텍스트
- MacroHtml - HTML 조각 출력
4. 미디어/파일
- MacroImage - 이미지 삽입
- MacroAttachment - S3 파일 첨부
- MacroEmbed - YouTube 임베드
5. 페이지 삽입
- MacroInclude - 다른 페이지 포함
- MacroInlineDays - 특정 월의 일별 페이지를 한 문서로 끌어오기
6. 날짜/시간
- MacroPeriod - 날짜 간격 계산
- MacroCalendar - 달력 보기
- MacroDayHeader - 날짜 페이지 헤더
- MacroLinkDate - 날짜 관련 링크 모음
- MacroOnThisDay - 같은 월·일에 날짜 속성이 걸린 페이지 (해는 무관)
- MacroWeekdayName - 요일 이름
- MacroMonthName - 월 이름
- MacroNavigationYear - 연도 탐색 박스
- MacroNavigationYearMonth - 연월 탐색 박스
- MacroYears - 위키에 링크된 연도 목록
7. 페이지 목록/탐색
- MacroNavigation - 탐색 메뉴 링크
- MacroPageList - 전체 페이지 목록 표
- MacroTitleIndex - 가나다/ABC 순 제목 색인
- MacroRecentChanges - 최근 변경 목록
- MacroWikiStatistics - 위키 통계
- MacroPageCount - 전체 페이지 수
- MacroPageMap - 전체 페이지 링크 그래프
- MacroAdjacentPages - 현재 페이지 연결 그래프
8. 역링크/연관 페이지
- MacroBacklinks - 현재 페이지로의 역링크
- MacroUnlinkedMentions - 이름은 적었지만 링크는 안 건 페이지를 찾는 단추
- MacroTwinPages - Sister Wiki의 동명 페이지
- MacroSimilarPages - 유사 페이지 (코사인 유사도)
- MacroPercentLinkTitle - 비율 막대가 붙은 링크
- MacroAhaWikiSiteList - AhaWiki 사이트 목록
9. 변수
문서 안 변수는 매크로가 아니라 #!var 디렉티브와 {{이름}} 입니다 — Variable.
- MacroGetMacroSet - 2026-09-08에 폐기한 옛 매크로
Set/Get
10. 폼/입력
- MacroCheckBox - 체크박스
11. 상태 메시지
12. 시스템 정보
- MacroSiteName - 사이트 이름 출력
- MacroUptime - 서버(JVM)가 시작한 시각
- MacroThemes - 테마 토큰 미리보기
13. See Also
13.1. Backlinks
- AhaMark
- AhaMark Basic
- Dev Logs
- Features
- Interpreter
- MacroAdjacentPages
- MacroAhaWikiSiteList
- MacroAttachment
- MacroBacklinks
- MacroBr
- MacroCalendar
- MacroCheckBox
- MacroColorCode
- MacroCopyable
- MacroDayHeader
- MacroEmbed
- MacroGetMacroSet
- MacroHtml
- MacroImage
- MacroInclude
- MacroInlineDays
- MacroKbd
- MacroLinkDate
- MacroMonthName
- MacroNavigation
- MacroNavigationYear
- MacroNavigationYearMonth
- MacroOnThisDay
- MacroPageCount
- MacroPageList
- MacroPageMap
- MacroPercentLinkTitle
- MacroPeriod
- MacroRecentChanges
- MacroRuby
- MacroSimilarPages
- MacroSiteName
- MacroSuccessMacroErrorMacroInfo
- MacroThemes
- MacroTitleIndex
- MacroTrivial
- MacroTwinPages
- MacroUnlinkedMentions
- MacroUptime
- MacroWeekdayName
- MacroWikiStatistics
- MacroYears
- Scala Play Framework 위키 엔진
- ToDo
13.2. Similar Pages
Similar pages by cosine similarity. Words after page name are term frequency.